إنشاء وتشغيل مشروع Zend Framework

ما هو Zend Framework؟

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

الميزات والفوائد الرئيسية لـ Zend Framework

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

Zend Framework مناسب لبناء تطبيقات ويب وواجهات برمجة التطبيقات عالية الجودة، ويصلح للمشاريع الصغيرة حتى الأنظمة المؤسساتية الكبيرة.

استخدام ServBay لإنشاء وتشغيل مشروع Zend Framework

في هذه المقالة، سنستخدم بيئة PHP التي تقدمها ServBay لإنشاء وتشغيل مشروع Zend Framework. سنستخدم ميزة "المضيف" في ServBay لإعداد خادم ويب والوصول إلى المشروع من خلال إعداد بسيط.

ملاحظة: إذا كنت قد استخدمت NGINX أو Apache من قبل

يستخدم ServBay خادم Caddy افتراضياً. للمستخدمين الذين ينتقلون من NGINX وApache إلى ServBay، هناك بعض التغييرات الرئيسية التي يجب ملاحظتها:

1. تكوين Caddy

   تم تضمين Caddy داخل ServBay بالفعل، وتم تحسين إعداداته وتدقيقها افتراضياً. يحتاج المطور فقط إلى استخدام ميزة "المضيف" في ServBay لإدارة المواقع دون الحاجة إلى تعديل ملف تكوين Caddy يدوياً.

2. قواعد Rewrite و.htaccess

   في NGINX وApache، يحتاج المطورون عادة إلى كتابة قواعد Rewrite وملفات .htaccess بأنفسهم لمعالجة إعادة كتابة URL وتكوينات أخرى. ومع ذلك، يأتي ServBay مع إعدادات Caddy مهيأة مسبقاً، لذا لا يلزم كتابة هذه القواعد إلا إذا كانت هناك حاجة خاصة.

3. تعرف على المزيد

   للمزيد من المعلومات، يرجى مراجعة Rewrite و htaccess، كيفية نقل موقع Apache إلى ServBay، كيفية نقل موقع NGINX إلى ServBay.

إنشاء مشروع Zend Framework

TIP

توصي ServBay بأن يقوم المطورون بوضع مواقعهم تحت دليل /Applications/ServBay/www لأجل سهولة الإدارة.

1. تثبيت Composer

   يأتي ServBay مثبتاً مع Composer تلقائياً، لذا لا حاجة لتثبيته منفصلاً.

2. إنشاء مشروع Zend Framework

   استخدم Composer لإنشاء مشروع Zend Framework جديد:

   cd /Applications/ServBay/www
   mkdir servbay-zend-app
   cd servbay-zend-app
   composer create-project zendframework/skeleton-application .

3. الدخول إلى مجلد المشروع

   ادخل إلى مجلد مشروع Zend Framework الجديد:

   cd /Applications/ServBay/www/servbay-zend-app

تكوين التهيئة

1. تكوين متغيرات البيئة

   قم بتكوين معلومات الاتصال بقاعدة البيانات والمتغيرات البيئية الأخرى في ملف config/autoload/global.php. تأكد من إعداد التهيئة التالية بشكل صحيح:

   return [
       'db' => [
           'driver' => 'Pdo_Mysql',
           'database' => 'servbay_zend_app',
           'username' => 'root',
           'password' => 'password',
           'hostname' => '127.0.0.1',
       ],
   ];

تكوين خادم الويب

استخدم ميزة "المضيف" في ServBay للوصول إلى مشروع Zend Framework من خلال خادم الويب. في إعدادات "المضيف" في ServBay، أضف مضيفًا جديدًا:

• الاسم: My First Zend Dev Site
• اسم النطاق: servbay-zend-test.local
• نوع الموقع: PHP
• إصدار PHP: اختر 8.3
• دليل الجذر للموقع: /Applications/ServBay/www/servbay-zend-app/public

يرجى مراجعة إضافة أول موقع للخطوات التفصيلية.

إضافة كود مثالي

أضف الكود التالي في ملف module/Application/config/module.config.php لعرض "Hello ServBay!":

return [
    'router' => [
        'routes' => [
            'home' => [
                'type' => 'Literal',
                'options' => [
                    'route'    => '/',
                    'defaults' => [
                        'controller' => 'Application\Controller\Index',
                        'action'     => 'index',
                    ],
                ],
            ],
        ],
    ],
    'controllers' => [
        'factories' => [
            'Application\Controller\Index' => InvokableFactory::class,
        ],
    ],
    'view_manager' => [
        'template_path_stack' => [
            __DIR__ . '/../view',
        ],
    ],
];

أضف الكود التالي في ملف module/Application/src/Controller/IndexController.php:

namespace Application\Controller;

use Laminas\Mvc\Controller\AbstractActionController;
use Laminas\View\Model\ViewModel;

class IndexController extends AbstractActionController
{
    public function indexAction()
    {
        return new ViewModel([
            'message' => 'Hello ServBay!',
        ]);
    }
}

أضف الكود التالي في ملف module/Application/view/application/index/index.phtml:

<?php echo $this->message; ?>

زيارة الموقع

افتح المتصفح وزيارة https://servbay-zend-test.local، سترى الصفحة تعرض Hello ServBay!.

أمثلة قواعد بيانات NoSQL

مثال Memcached

1. تثبيت امتداد Memcached

   يحتوي ServBay على امتداد Memcached مثبت مسبقًا، لذا لا حاجة لتثبيته.

2. تكوين Memcached

   أضف تبعية Memcached إلى ملف composer.json:

   {
       "require": {
           "laminas/laminas-cache-storage-adapter-memcached": "^2.0"
       }
   }

   ثم شغل composer update لتثبيت التبعيات.

3. تكوين التوجيه

   أضف الكود التالي في ملف module/Application/config/module.config.php لتكوين التوجيه:

   return [
       'router' => [
           'routes' => [
               'memcached' => [
                   'type' => 'Literal',
                   'options' => [
                       'route'    => '/memcached',
                       'defaults' => [
                           'controller' => 'Application\Controller\Index',
                           'action'     => 'memcached',
                       ],
                   ],
               ],
           ],
       ],
   ];

4. استخدام Memcached

   استخدم التخزين المؤقت في وحدة التحكم:

   namespace Application\Controller;
   
   use Laminas\Mvc\Controller\AbstractActionController;
   use Laminas\View\Model\ViewModel;
   use Laminas\Cache\StorageFactory;
   
   class IndexController extends AbstractActionController
   {
       public function memcachedAction()
       {
           $cache = StorageFactory::factory([
               'adapter' => [
                   'name'    => 'memcached',
                   'options' => [
                       'servers' => [
                           ['127.0.0.1', 11211],
                       ],
                   ],
               ],
           ]);
   
           $cacheKey = 'my_cache_key';
           $cachedData = $cache->getItem($cacheKey, $success);
   
           if (!$success) {
               $cachedData = 'Hello Memcached!';
               $cache->setItem($cacheKey, $cachedData);
           }
   
           return new ViewModel([
               'message' => $cachedData,
           ]);
       }
   }

   أضف الكود التالي في ملف module/Application/view/application/index/memcached.phtml:

   <?php echo $this->message; ?>

   افتح المتصفح وزيارة https://servbay-zend-test.local/memcached

مثال Redis

1. تثبيت امتداد Redis

   يحتوي ServBay على امتداد Redis مثبت مسبقًا، لذا لا حاجة لتثبيته.

2. تكوين Redis

   أضف تبعية Redis إلى ملف composer.json:

   {
       "require": {
           "laminas/laminas-cache-storage-adapter-redis": "^2.0"
       }
   }

   ثم شغل composer update لتثبيت التبعيات.

3. تكوين التوجيه

   أضف الكود التالي في ملف module/Application/config/module.config.php لتكوين التوجيه:

   return [
       'router' => [
           'routes' => [
               'redis' => [
                   'type' => 'Literal',
                   'options' => [
                       'route'    => '/redis',
                       'defaults' => [
                           'controller' => 'Application\Controller\Index',
                           'action'     => 'redis',
                       ],
                   ],
               ],
           ],
       ],
   ];

4. استخدام Redis

   استخدم التخزين المؤقت في وحدة التحكم:

   namespace Application\Controller;
   
   use Laminas\Mvc\Controller\AbstractActionController;
   use Laminas\View\Model\ViewModel;
   use Laminas\Cache\StorageFactory;
   
   class IndexController extends AbstractActionController
   {
       public function redisAction()
       {
           $cache = StorageFactory::factory([
               'adapter' => [
                   'name'    => 'redis',
                   'options' => [
                       'server' => [
                           'host' => '127.0.0.1',
                           'port' => 6379,
                       ],
                   ],
               ],
           ]);
   
           $cacheKey = 'my_cache_key';
           $cachedData = $cache->getItem($cacheKey, $success);
   
           if (!$success) {
               $cachedData = 'Hello Redis!';
               $cache->setItem($cacheKey, $cachedData);
           }
   
           return new ViewModel([
               'message' => $cachedData,
           ]);
       }
   }

   أضف الكود التالي في ملف module/Application/view/application/index/redis.phtml:

   <?php echo $this->message; ?>

   افتح المتصفح وزيارة https://servbay-zend-test.local/redis

أمثلة قواعد البيانات العلائقية

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

1. إنشاء ملف ترحيل

   استخدم أداة الترحيل في Laminas لإنشاء ملف ترحيل:

   composer require laminas/laminas-db

2. تحرير ملف الترحيل

   أنشئ ملف ترحيل جديد في دليل data/migrations وقم بتحريره لتعريف هيكل جداول قاعدة البيانات:

   use Laminas\Db\Adapter\Adapter;
   use Laminas\Db\Sql\Sql;
   
   class CreateUsersTable
   {
       public function up(Adapter $adapter)
       {
           $sql = nouvo هيئة Sql;
           $create = $sql->createTable('users')
                         ->addColumn('id', 'integer', ['auto_increment' => true])
                         ->addColumn('name', 'varchar', ['length' => 255])
                         ->addColumn('email', 'varchar', ['length' => 255, 'unique' => true])
                         ->addPrimaryKey('id');
   
           $adapter->query(
               $sql->buildSqlString($create),
               Adapter::QUERY_MODE_EXECUTE
           );
       }
   }

3. تشغيل الترحيل

   شغل الترحيل يدوياً لإنشاء جداول قاعدة البيانات:

   $adapter = new Adapter([
       'driver' => 'Pdo_Mysql',
       'database' => 'servbay_zend_app',
       'username' => 'root',
       'password' => 'password',
       'hostname' => '127.0.0.1',
   ]);
   
   $migration = new CreateUsersTable();
   $migration->up($adapter);

مثال MySQL

1. تكوين MySQL

   قم بتكوين معلومات اتصال MySQL في ملف config/autoload/global.php:

   return [
       'db' => [
           'driver' => 'Pdo_Mysql',
           'database' => 'servbay_zend_app',
           'username' => 'root',
           'password' => 'password',
           'hostname' => '127.0.0.1',
       ],
   ];

2. تكوين التوجيه

   أضف الكود التالي في ملف module/Application/config/module.config.php لتكوين التوجيه:

   return [
       'router' => [
           'routes' => [
               'mysql-add' => [
                   'type' => 'Literal',
                   'options' => [
                       'route'    => '/mysql-add',
                       'defaults' => [
                           'controller' => 'Application\Controller\Index',
                           'action'     => 'mysqlAdd',
                       ],
                   ],
               ],
               'mysql' => [
                   'type' => 'Literal',
                   'options' => [
                       'route'    => '/mysql',
                       'defaults' => [
                           'controller' => 'Application\Controller\Index',
                           'action'     => 'mysql',
                       ],
                   ],
               ],
           ],
       ],
   ];

3. إضافة بيانات المستخدم

   استخدم البيانات في وحدة التحكم:

   namespace Application\Controller;
   
   use Laminas\Mvc\Controller\AbstractActionController;
   use Laminas\View\Model\ViewModel;
   use Laminas\Db\Adapter\Adapter;
   use Laminas\Db\Sql\Sql;
   
   class IndexController extends AbstractActionController
   {
       protected $adapter;
   
       public function __construct(Adapter $adapter)
       {
           $this->$adapter = $adapter;
       }
   
       public function mysqlAddAction()
       {
           $sql = new Sql($this->adapter);
           $insert = $sql->insert('users')
                         ->values([
                             'name' => 'ServBay',
                             'email' => '[email protected]',
                         ]);
   
           $this->adapter->query(
               $sql->buildSqlString($insert),
               Adapter::QUERY_MODE_EXECUTE
           );
   
           return new ViewModel([
               'message' => 'User added',
           ]);
       }
   
       public function mysqlAction()
       {
           $sql = new Sql($this->adapter);
           $select = $sql->select('users');
   
           $result = $this->adapter->query(
               $sql->buildSqlString($select),
               Adapter::QUERY_MODE_EXECUTE
           );
   
           $users = [];
           foreach ($result as $row) {
               $users[] = $row;
           }
   
           return new ViewModel([
               'users' => json_encode($users),
           ]);
       }
   }

   أضف الكود التالي في ملف module/Application/view/application/index/mysql-add.phtml:

   <?php echo $this->message; ?>

   أضف الكود التالي في ملف module/Application/view/application/index/mysql.phtml:

   <?php echo $this->users; ?>

   افتح المتصفح وزيارة https://servbay-zend-test.local/mysql-add وhttps://servbay-zend-test.local/mysql

مثال PostgreSQL

1. تكوين PostgreSQL

   قم بتكوين معلومات اتصال PostgreSQL في ملف config/autoload/global.php:

   return [
       'db' => [
           'driver' => 'Pdo_Pgsql',
           'database' => 'servbay_zend_app',
           'username' => 'root',
           'password' => 'password',
           'hostname' => '127.0.0.1',
       ],
   ];

2. تكوين التوجيه

   أضف الكود التالي في ملف module/Application/config/module.config.php لتكوين التوجيه:

   return [
       'router' => [
           'routes' => [
               'pgsql-add' => [
                   'type' => 'Literal',
                   'options' => [
                       'route'    => '/pgsql-add',
                       'defaults' => [
                           'controller' => 'Application\Controller\Index',
                           'action'     => 'pgsqlAdd',
                       ],
                   ],
               ],
               'pgsql' => [
                   'type' => 'Literal',
                   'options' => [
                       'route'    => '/pgsql',
                       'defaults' => [
                           'controller' => 'Application\Controller\Index',
                           'action'     => 'pgsql',
                       ],
                   ],
               ],
           ],
       ],
   ];

3. إضافة بيانات المستخدم

   استخدم البيانات في وحدة التحكم:

   namespace Application\Controller;
   
   use Laminas\Mvc\Controller\AbstractActionController;
   use Laminas\View\Model\ViewModel;
   use Laminas\Db\Adapter\Adapter;
   use Laminas\Db\Sql\Sql;
   
   class IndexController extends AbstractActionController
   {
       protected $adapter;
   
       public function __construct(Adapter $adapter)
       {
           $this->adapter = $adapter;
       }
   
       public function pgsqlAddAction()
       {
           $sql = new Sql($this->adapter);
           $insert = $sql->insert('users')
                         ->values([
                             'name' => 'ServBay',
                             'email' => '[email protected]',
                         ]);
   
           $this->adapter->query(
               $sql->buildSqlString($insert),
               Adapter::QUERY_MODE_EXECUTE
           );
   
           return new ViewModel([
               'message' => 'User added',
           ]);
       }
   
       public function pgsqlAction()
       {
           $sql = new Sql($this->adapter);
           $select = $sql->select('users');
   
           $result = $this->adapter->query(
               $sql->buildSqlString($select),
               Adapter::QUERY_MODE_EXECUTE
           );
   
           $users = [];
           foreach ($result

as $row) { $users[] =