PHPの変数：宣言・スコープ・globalとstatic

PHPの変数は$で始まる名前で、値を代入すると作られます：$name = "Ada";。値が型を決めるので、宣言用のキーワードも型の指定もありません。あとから別の型の値を代入することもできます。

<?php
$name = "Ada";
$age = 36;
$height = 1.65;
$isAdmin = true;

echo "$name is $age years old\n";

$age = $age + 1;           // update the value
$age++;                    // add one more
echo "Two birthdays later: $age\n";

$age = "thirty-eight";     // the type can change too
echo "Now a string: $age\n";

変数の命名規則

変数名は$で始まり、次に英字かアンダースコア、そのあとは英字、数字、アンダースコアを自由に続けます。ASCII以外の文字も英字として扱われるので$名前も有効ですが、ASCIIの名前が普通です。名前は大文字と小文字を区別します。

つまり$city、$City、$CITYは3つの別々の変数です。snake_case（$first_name）かcamelCase（$firstName）を使い、プロジェクト内では1つのスタイルに統一しましょう。PSRのコーディング規約は変数の命名をあえて決めていません。LaravelやSymfonyのコードではおもにcamelCaseが使われています。

文字列の中で変数を使う

ダブルクォートの中では、PHPは変数をその値に置き換えます。シングルクォートの中では置き換えません。変数の直後に文字が続くときや、文字列キーで配列の要素にアクセスするときは、変数を波括弧で囲みます。

<?php
$fruit = "apple";
$basket = ["count" => 4];

echo "I like $fruit pie\n";
echo 'I like $fruit pie' . "\n";              // single quotes: printed as written
echo "Two {$fruit}s please\n";                // braces separate the name
echo "There are {$basket['count']} left\n";   // array key inside a string
echo "Joined: " . $fruit . " and pear\n";     // concatenation with .

引用符、連結、変数展開については文字列のページで詳しく説明しています。

未定義の変数と既定値

一度も代入していない変数を読むとnullになり、PHPは警告を表示します。

Warning: Undefined variable $discount in /home/index.php on line 3

先にissetで確認するか、null合体演算子??で既定値を与えます。どちらも警告なしで動きます。

<?php
$price = 50;

$discount = $discount ?? 0;    // use 0 when $discount is not set
echo "Price: " . ($price - $discount) . "\n";

if (isset($coupon)) {
    echo "Coupon: $coupon\n";
} else {
    echo "No coupon given\n";
}

$coupon = null;
var_dump(isset($coupon));      // a variable holding null counts as not set

$x ??= 0;は$x = $x ?? 0;の短縮形です。フォームやURLの値がよくある使いどころです：$page = $_GET['page'] ?? 1;。

関数の中の変数スコープ

関数の外で定義した変数は関数の中からは見えず、関数の中で作った変数は関数が戻ると消えます。JavaScriptから来た人がいちばん驚くところです。

<?php
$taxRate = 0.2;

function priceWithTax($price)
{
    // $taxRate does not exist here, so ?? falls back to 0
    return $price * (1 + ($taxRate ?? 0));
}

function priceWithTaxFixed($price, $rate)
{
    return $price * (1 + $rate);   // pass what the function needs
}

echo priceWithTax(100), "\n";
echo priceWithTaxFixed(100, $taxRate), "\n";

?? 0がなければ、最初の関数は未定義の$taxRateについて警告を出します。値を引数として渡すと、関数の動きが予測しやすくなりテストもしやすくなるので、まずはこの方法を選びましょう。引数と戻り値については関数のページで扱っています。

globalキーワードと$GLOBALS

関数がどうしてもグローバル変数を使う必要があるときは、globalで宣言するか、すべてのグローバル変数を名前で保持している$GLOBALS配列を使います。

<?php
$visits = 0;
$siteName = "Bakery";

function countVisit()
{
    global $visits;      // now $visits refers to the global variable
    $visits++;
}

function title()
{
    return "Welcome to " . $GLOBALS['siteName'];
}

countVisit();
countVisit();
echo "Visits: $visits\n";
echo title(), "\n";

グローバル変数はどの関数からでも変更できるので、コードを追いにくくします。古いコードやWordPressのプラグイン（global $wpdb;）には出てきますが、新しいコードでは値を渡すかクラスを使いましょう。

static変数は値を保持する

関数の中のstatic変数は1回だけ作られ、呼び出しの間で値を保持します。それでもローカル変数なので、関数の外のコードからは見えません。

<?php
function nextTicket(): int
{
    static $number = 100;   // runs only on the first call
    $number++;
    return $number;
}

echo nextTicket(), "\n";
echo nextTicket(), "\n";
echo nextTicket(), "\n";

function expensiveLookup(string $key): string
{
    static $cache = [];
    if (!isset($cache[$key])) {
        echo "(computing $key) ";
        $cache[$key] = strtoupper($key);
    }
    return $cache[$key];
}

echo expensiveLookup("php"), "\n";
echo expensiveLookup("php"), "\n";   // second call uses the cache

可変変数（$$name）

$$nameは、$nameの値を別の変数の名前として使います。動きはしますが、ほとんどの場合は配列のほうが同じことをわかりやすく書けます。

<?php
$field = "color";
$$field = "blue";        // creates $color
echo $color, "\n";

// The clearer way to have names chosen at runtime:
$settings = [];
$settings[$field] = "blue";
echo $settings["color"], "\n";

コピーと参照

変数を別の変数に代入すると、配列も含めて値がコピーされます。代わりに両方の名前が同じ値を指すようにするには、前に&を付けます。

<?php
$a = [1, 2, 3];
$b = $a;          // copy
$b[] = 4;
echo "a has " . count($a) . ", b has " . count($b) . "\n";

$c = &$a;         // reference: $c and $a are the same array
$c[] = 99;
echo "a has " . count($a) . " after changing c\n";

function addBonus(int &$points)
{
    $points += 10;
}
$score = 5;
addBonus($score);
echo "Score: $score\n";

unset($b);
var_dump(isset($b));

オブジェクトは扱いが違います。オブジェクトを代入すると同じオブジェクトへのハンドルがコピーされるので、どちらの変数を通した変更も両方から見えます。本当のコピーにはcloneを使います。

よくあるミス：ifやループの中で代入した変数

PHPにはブロックスコープがないので、if、for、foreachの中で作った変数はそのあとも存在し続けます。便利ですが、バグも隠れます。ブロックが実行されなかった場合、変数は作られていないのです。

<?php
$orders = [];   // try [120, 80] here

$message = "No orders yet";   // set a default before the loop
foreach ($orders as $amount) {
    $message = "Last order: $amount";
}
echo $message, "\n";

foreach ([1, 2, 3] as $n) {
    $last = $n;
}
echo "Still visible after the loop: $last\n";

既定値の行がなければ、$ordersが空のとき$messageは未定義のままになり、警告が表示されます。値をセットするかもしれないブロックの前に、すべての変数に値を入れておきましょう。