المتغيرات في 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";

قواعد تسمية المتغيرات

يبدأ اسم المتغير بالرمز $، ثم حرف أو شرطة سفلية، ثم أي عدد من الأحرف أو الأرقام أو الشرطات السفلية. تُعد الأحرف غير اللاتينية أحرفًا، لذا فإن $名前 صالح، لكن الأسماء اللاتينية هي المعتادة. والأسماء حساسة لحالة الأحرف.

إذن $city و$City و$CITY ثلاثة متغيرات مختلفة. استخدم snake_case ($first_name) أو camelCase ($firstName)، والتزم بأسلوب واحد في كل مشروع. تترك معايير الكتابة 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;. وقيم النماذج والروابط هي الحالة المعتادة: $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";

المتغيرات العامة تجعل الكود أصعب في التتبع، لأن أي دالة تستطيع تغييرها. وهي تظهر في الكود القديم وفي إضافات ووردبريس (global $wpdb;)، أما في الكود الجديد فمرّر القيم أو استخدم صنفًا.

المتغيرات static تحتفظ بقيمتها

يُنشأ المتغير static داخل الدالة مرة واحدة ويحتفظ بقيمته بين الاستدعاءات. وهو يبقى محليًا: لا يستطيع الكود خارج الدالة رؤيته.

<?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 غير معرّف وتطبع تحذيرًا. أعطِ كل متغير قيمة قبل الكتلة التي قد تعيّنه.