أساسيات PHP

صياغة PHP وأول برنامج نصي

13 دقيقة الدرس 2 من 45

صياغة PHP وأول برنامج نصي

الآن بعد أن فهمت ما هي PHP، حان الوقت لكتابة أول برنامج نصي PHP الخاص بك! في هذا الدرس، سنغطي أساسيات صياغة PHP، وكيفية تضمين PHP في HTML، وإنشاء أول ملف PHP عامل لك.

علامات PHP

يجب إحاطة كود PHP بعلامات PHP خاصة. عندما يرى مفسر PHP هذه العلامات، فإنه يعرف أنه يجب معالجة الكود بداخلها.

علامات PHP القياسية (موصى بها):
<?php
    // كود PHP الخاص بك هنا
?>

علامة Echo القصيرة (PHP 5.4+):
<?= "هذا مخرج" ?>

علامة الفتح القصيرة (غير موصى بها):
<?
    // تتطلب تمكين short_open_tag
?>

أفضل ممارسة: استخدم دائماً علامات <?php ?> القياسية للحصول على أقصى قدر من التوافق. العلامات القصيرة قد لا تعمل على جميع الخوادم.

قواعد الصياغة الأساسية

لدى PHP قواعد صياغة محددة يجب عليك اتباعها:

1. تنتهي الجمل بفاصلة منقوطة:
<?php
    echo "Hello World";  // فاصلة منقوطة مطلوبة
    $name = "John";      // فاصلة منقوطة مطلوبة
?>

2. PHP حساسة لحالة الأحرف للمتغيرات:
<?php
    $name = "John";   // مختلف عن
    $Name = "Jane";   // هذان متغيران مختلفان
?>

3. PHP غير حساسة لحالة الأحرف للكلمات المفتاحية والدوال:
<?php
    ECHO "Hello";   // يعمل
    echo "Hello";   // يعمل (مفضل)
    Echo "Hello";   // يعمل
?>

مهم: بينما الكلمات المفتاحية غير حساسة لحالة الأحرف، أسماء المتغيرات حساسة لحالة الأحرف. $name و $Name متغيران مختلفان!

التعليقات في PHP

التعليقات تساعد في توثيق الكود الخاص بك ويتجاهلها مفسر PHP:

<?php
    // تعليق سطر واحد

    # تعليق آخر سطر واحد (نمط Unix)

    /*
        تعليق متعدد الأسطر
        يمكن أن يمتد عبر أسطر متعددة
        رائع للتوثيق
    */

    echo "Hello"; // تعليق ضمن السطر

    /**
     * كتلة تعليق PHPDoc
     * تُستخدم لتوثيق الدوال والفئات
     * @param string $name
     * @return void
     */
?>

أفضل ممارسة: استخدم // لتعليقات السطر الواحد و /* */ للتعليقات متعددة الأسطر. استخدم PHPDoc /** */ لتوثيق الدوال والفئات.

أول برنامج نصي PHP الخاص بك

دعنا ننشئ ملف PHP كامل. احفظ هذا كـ hello.php:

<!DOCTYPE html>
<html lang="ar" dir="rtl">
<head>
    <meta charset="UTF-8">
    <title>أول برنامج نصي PHP الخاص بي</title>
</head>
<body>
    <h1>مرحباً بك في PHP!</h1>

    <?php
        echo "<p>هذه الفقرة تم توليدها بواسطة PHP!</p>";
        echo "<p>التاريخ الحالي هو: " . date("Y-m-d") . "</p>";
    ?>

    <p>هذا HTML عادي.</p>
</body>
</html>

مهم: يجب معالجة ملفات PHP بواسطة خادم ويب مثبت عليه PHP. لا يمكنك ببساطة فتحها في المتصفح مثل ملفات HTML.

جملتي echo و print

توفر PHP طريقتين لإخراج البيانات: echo و print. كلاهما يستخدم لعرض المخرجات، ولكن لهما اختلافات طفيفة:

جملة echo:
<?php
    echo "Hello World";
    echo "Hello", " ", "World";  // يمكن أن تأخذ معاملات متعددة
    echo "<h1>Title</h1>";     // يمكن إخراج HTML
?>

جملة print:
<?php
    print "Hello World";
    print("Hello World");         // الأقواس اختيارية
    // print "Hi", "There";       // خطأ: print تأخذ معامل واحد فقط
?>

الاختلافات:
- echo: لا قيمة إرجاع، أسرع قليلاً، يقبل وسائط متعددة
- print: يعيد 1، يمكن استخدامه في التعبيرات، يقبل وسيطة واحدة

توصية: استخدم echo في معظم الحالات. إنه أسرع وأكثر مرونة. استخدم print فقط عندما تحتاج إلى قيمة الإرجاع الخاصة به (نادراً).

دمج PHP مع HTML

إحدى نقاط قوة PHP هي التكامل السلس مع HTML. يمكنك التبديل بين PHP و HTML بحرية:

<!DOCTYPE html>
<html>
<head>
    <title>PHP و HTML</title>
</head>
<body>
    <h1>معلومات المستخدم</h1>

    <?php
        $username = "JohnDoe";
        $email = "john@example.com";
    ?>

    <p>اسم المستخدم: <?= $username ?></p>
    <p>البريد الإلكتروني: <?= $email ?></p>

    <?php if ($username == "JohnDoe"): ?>
        <p>مرحباً بعودتك، John!</p>
    <?php endif; ?>
</body>
</html>

المسافات البيضاء والتنسيق

تتجاهل PHP المسافات البيضاء الزائدة، مما يسمح لك بتنسيق الكود لسهولة القراءة:

كل هذه متكافئة:

<?php echo "Hello"; ?>

<?php
    echo "Hello";
?>

<?php
    echo
        "Hello"
    ;
?>

أفضل ممارسة: استخدم مسافة بادئة متسقة (4 مسافات أو 1 تاب) وضع الأقواس الافتتاحية على نفس السطر مع الجمل لسهولة القراءة بشكل أفضل.

بنية ملف PHP

يتبع ملف PHP جيد التنظيم عادةً هذا النمط:

<?php
// 1. تعليق على مستوى الملف (اختياري لكن موصى به)
/**
 * وصف لما يفعله هذا الملف
 * @author اسمك
 * @date 2024-01-15
 */

// 2. تكوين PHP (إذا لزم الأمر)
error_reporting(E_ALL);

// 3. جمل include/require
// require_once 'config.php';

// 4. إعلانات المتغيرات
$siteName = "موقعي";
$year = date("Y");

// 5. الدوال (سنتعلمها لاحقاً)
// function greet($name) { ... }

// 6. منطق الكود الرئيسي
?>

<!-- 7. مخرج HTML -->
<!DOCTYPE html>
<html>
<head>
    <title><?= $siteName ?></title>
</head>
<body>
    <h1><?= $siteName ?></h1>
    <p>حقوق النشر &copy; <?= $year ?></p>
</body>
</html>

تشغيل برنامج PHP النصي الخاص بك

لتشغيل برنامج PHP النصي الخاص بك، تحتاج إلى خادم ويب. إليك الطرق الشائعة:

الطريقة 1: خادم PHP المدمج (اختبار سريع)
1. افتح الطرفية/موجه الأوامر
2. انتقل إلى مجلد مشروعك
3. شغّل: php -S localhost:8000
4. زُر: http://localhost:8000/hello.php

الطريقة 2: XAMPP/WAMP/MAMP
1. احفظ الملف في مجلد htdocs (XAMPP) أو مجلد www (WAMP)
2. ابدأ خادم Apache
3. زُر: http://localhost/hello.php

الطريقة 3: خادم الإنتاج
حمّل عبر FTP وتصفح من خلال نطاقك

خطأ شائع: فتح ملفات PHP مباشرة في المتصفح (file:///path/to/file.php) لن يعمل. يجب معالجة PHP بواسطة خادم!

عرض مخرجات PHP

فهم ما يتلقاه المتصفح مقابل ما تكتبه:

ما تكتبه (hello.php):
<?php
    $greeting = "مرحباً";
    echo "<h1>" . $greeting . " بالعالم!</h1>";
?>

ما يتلقاه المتصفح (عرض المصدر):
<h1>مرحباً بالعالم!</h1>

ما يعرضه المتصفح:
[عنوان كبير يعرض: مرحباً بالعالم!]

نقطة أساسية: المتصفح لا يرى أبداً كود PHP الخاص بك - فقط مخرجات HTML التي تولدها PHP!

أخطاء الصياغة الشائعة

تجنب هذه الأخطاء الشائعة التي يرتكبها المبتدئون:

❌ نسيان الفاصلة المنقوطة:
<?php
    echo "Hello"  // خطأ: فاصلة منقوطة مفقودة
?>

✓ صحيح:
<?php
    echo "Hello";
?>

❌ علامة الإغلاق المفقودة (في PHP/HTML مختلط):
<?php
    echo "Hello";
// ?> مفقود
<p>HTML هنا</p>

✓ صحيح:
<?php
    echo "Hello";
?>
<p>HTML هنا</p>

❌ استخدام خاطئ للاقتباسات:
<?php
    echo 'He said "Hello"';  // يعمل لكن تجنب الخلط
?>

✓ صحيح:
<?php
    echo "He said \"Hello\"";  // اقتباسات مُهرَّبة
    // أو
    echo 'He said "Hello"';   // اقتباسات مفردة مع مزدوجة بالداخل
?>

تمرين عملي:

المهمة: أنشئ ملفاً باسم about.php يعرض:

اسمك في علامة <h1> (باستخدام PHP echo)
لغة البرمجة المفضلة لديك في علامة <p> (باستخدام PHP)
السنة الحالية (باستخدام دالة PHP date("Y"))
تذييل مع "صنع بـ PHP" (في HTML)

الحل:

<!DOCTYPE html>
<html>
<head>
    <title>عني</title>
</head>
<body>
    <?php
        $name = "اسمك";
        $language = "PHP";
    ?>

    <h1><?= $name ?></h1>
    <p>لغتي المفضلة هي <?= $language ?></p>
    <p>السنة: <?= date("Y") ?></p>

    <footer>صنع بـ PHP</footer>
</body>
</html>

الملخص

في هذا الدرس، تعلمت:

يجب إحاطة كود PHP بعلامات <?php ?>
تنتهي الجمل بفاصلة منقوطة
أسماء المتغيرات حساسة لحالة الأحرف
استخدم echo لإخراج البيانات
يمكن دمج PHP مع HTML بسلاسة
التعليقات تساعد في توثيق الكود الخاص بك
يجب معالجة ملفات PHP بواسطة خادم ويب

التالي: في الدرس التالي، سنتعمق في المتغيرات وأنواع البيانات - اللبنات الأساسية لأي برنامج PHP!