Zend Expressive模塊快速開髮指南：構(gòu)建只讀博客模塊

本文將分享一些Zend Expressive模塊開發(fā)技巧，幫助您快速構(gòu)建一個(gè)功能完善的只讀博客模塊。請(qǐng)確保您已按照之前的教程設(shè)置好開發(fā)環(huán)境，包括安裝和配置Zend Expressive、Doctrine、Gulp以及抽象反射工廠（約需10分鐘）。

在本教程中，我們將快速構(gòu)建一個(gè)簡(jiǎn)單的只讀博客模塊（從數(shù)據(jù)庫中列出博客文章），展示Zend Expressive的快速開發(fā)能力。

模塊設(shè)置

在您的Expressive應(yīng)用中運(yùn)行以下命令：

./vendor/bin/expressive module:create Blog

這將生成Blog模塊的基本代碼，並自動(dòng)將其註冊(cè)到您的應(yīng)用程序和Composer自動(dòng)加載器中。

Doctrine實(shí)體和數(shù)據(jù)庫表

接下來，創(chuàng)建Blog實(shí)體和數(shù)據(jù)庫表。首先，我們需要讓應(yīng)用程序知道該模塊提供了Doctrine實(shí)體。

打開src/Blog/src/ConfigProvider.php，添加以下代碼：

public function __invoke()
{
    return [
        'dependencies' => $this->getDependencies(),
        'doctrine'     => $this->getDoctrine(),
        'templates'    => $this->getTemplates(),
    ];
}

public function getDoctrine(): array
{
    return [
        'driver' => [
            'orm_default' => [
                'drivers' => [
                    'Blog\Entity' => 'blog_entity',
                ],
            ],
            'blog_entity' => [
                'class' => \Doctrine\ORM\Mapping\Driver\SimplifiedYamlDriver::class,
                'cache' => 'array',
                'paths' => [
                    dirname(__DIR__) . '/config/doctrine' => 'Blog\Entity',
                ],
            ],
        ],
    ];
}

在src/Blog/config/doctrine目錄下創(chuàng)建BlogPost.orm.yml文件，內(nèi)容如下：

---
Blog\Entity\BlogPost:
  type: entity
  table: blog_post
  id:
    id:
      type: integer
      generator:
        strategy: AUTO
  fields:
    title:
      type: string
      length: 255
    content:
      type: string
      length: 16777215

運(yùn)行./vendor/bin/doctrine orm:generate-entities src。 由於Doctrine不支持PSR-4標(biāo)準(zhǔn)的目錄結(jié)構(gòu)，需要將src/Blog/Entity移動(dòng)到src/Blog/src/Entity。 然後運(yùn)行以下命令創(chuàng)建數(shù)據(jù)庫表：

./vendor/bin/doctrine orm:schema-tool:create

您可以運(yùn)行以下SQL語句填充數(shù)據(jù)庫表：

INSERT INTO expressive.blog_post VALUES 
(null, 'Post 1', 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.'),
(null, 'Post 2', 'Mauris in libero laoreet, euismod lorem eget, tincidunt justo.'),
(null, 'Post 3', 'Donec sed diam congue, ultrices tellus at, venenatis felis.');

路由設(shè)置

Expressive模塊不直接註冊(cè)路由。我們需要使用一個(gè)小技巧來實(shí)現(xiàn)：創(chuàng)建src/Blog/src/Factory/RoutesDelegator.php文件，內(nèi)容如下：

<?php
namespace Blog\Factory;

use Blog\Action;
use Psr\Container\ContainerInterface;
use Zend\Expressive\Application;

class RoutesDelegator
{
    public function __invoke(ContainerInterface $container, $serviceName, callable $callback)
    {
        $app = $callback();
        include __DIR__ . '/../../config/routes.php';
        return $app;
    }
}

在src/Blog/src/ConfigProvider.php的getDependencies()方法中添加以下代碼：

'delegators' => [
    \Zend\Expressive\Application::class => [
        Factory\RoutesDelegator::class,
    ],
],

創(chuàng)建src/Blog/config/routes.php文件，添加博客路由：

<?php

use Blog\Action;

$app->get('/blog', Action\BlogPostListAction::class, 'blog_post_list');
$app->get('/blog/view/:blog_post_id', Action\BlogPostViewAction::class, 'blog_post_view');

Action和模板

接下來，創(chuàng)建Action來處理路由請(qǐng)求，並創(chuàng)建模板文件。 (Action和模板代碼與原文相同，此處省略，請(qǐng)參考原文。)

創(chuàng)建、編輯和刪除功能的實(shí)現(xiàn)留作練習(xí)。

總結(jié)

本教程展示了使用Zend Expressive快速構(gòu)建只讀博客模塊的簡(jiǎn)易性。只需少量文件和幾分鐘的工作，即可創(chuàng)建一個(gè)從數(shù)據(jù)庫顯示文章的列表頁，並為後續(xù)添加/edit和/delete等路由做好準(zhǔn)備。

(以下為原文FAQs部分，略作調(diào)整)

Zend Expressive快速開發(fā)常見問題

• 什麼是Zend Expressive？ Zend Expressive是一個(gè)基於PHP的微型中間件框架，構(gòu)建於Zend Stratigility之上，支持PSR-7中間件。

• 如何安裝Zend Expressive？ 使用Composer：composer require zendframework/zend-expressive

• Zend Expressive的優(yōu)勢(shì)？ 快速開發(fā)、簡(jiǎn)單靈活，支持各種應(yīng)用類型（微服務(wù)到單體應(yīng)用），支持多種路由和模板系統(tǒng)。

• 如何在Zend Expressive中創(chuàng)建模塊？ 在應(yīng)用的src目錄下創(chuàng)建新目錄，包含ConfigProvider類，返回模塊配置數(shù)組（包含依賴項(xiàng)、路由和模板）。

• 如何在Zend Expressive中添加路由？ 在模塊ConfigProvider類的配置數(shù)組的routes鍵中添加新條目。

• 如何在Zend Expressive中使用模板？ Zend Expressive支持多種模板引擎（Twig、Plates、Zend View）。在ConfigProvider類的配置數(shù)組的templates鍵中添加條目。

• 如何在Zend Expressive中處理錯(cuò)誤？ Zend Expressive包含默認(rèn)錯(cuò)誤處理中間件。您可以創(chuàng)建自定義中間件來處理錯(cuò)誤。

• 如何測(cè)試Zend Expressive應(yīng)用？ 使用PHPUnit。

• 如何部署Zend Expressive應(yīng)用？ 像任何其他PHP應(yīng)用一樣部署，可以使用Apache、Nginx或PHP內(nèi)置服務(wù)器。

• 哪裡可以找到更多關(guān)於Zend Expressive的資源？ Zend Framework官方網(wǎng)站、Zend Expressive文檔和Zend Framework社區(qū)論壇。

以上是Zend表達(dá)模塊的快速發(fā)展的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！