PHP マイクロサービスコルーチンフレームワーク Swoft-PHPチュートリアル-php.cn

はじめに

swoole のような強力な拡張機能を使用して、swoole に基づいて開発されたフレームワークが増えています。Swoft はその 1 つです。優れた PHP フレームワークの一部。 Swoft は、Swoole のネイティブコルーチンに基づくアノテーションフレームワークで、常駐メモリと他の Swoole 関数のカプセル化が付属しています。 Swft にはコルーチンクライアントが組み込まれています。同時に、Swft には Aop などの新しい概念がたくさんあります。

公式サイトアドレス： https://www.swoft.org/

Swoft フレームワーク使用上の注意点

Swoft は Swoole をベースとしているため、通常の PHP フレームワークと互換性がありますが、依然として大きく異なるため、注意が必要なものもあります。

1. プロセス全体がブロックされるため、コード内で sleep() やその他のスリープ関数を実行しないでください。

2. ワーカープロセスが直接終了することになる exit/die 関数は使用しないでください。

3. プロセスの分離に注意が必要グローバル変数の値を変更しても、グローバル変数のメモリ空間は異なるプロセスに分離されているため、変更は反映されません。 Swoft フレームワークを使用するには、プロセス分離の問題を理解する必要があります。 PHP 変数は、グローバル変数であっても、異なるプロセス間で共有されません。異なるプロセスがデータを共有する必要がある場合は、Redis、Mysql、メッセージキュー、ファイル、Swoole/Table、APCu (php 独自のキャッシュ拡張機能)、shmget (プロセスコミュニケーション (IPC) 共有メモリ) などのツールを使用できます。同時に、異なるプロセスのファイルハンドルも分離されるため、プロセス A で作成された Socker 接続によって開かれたファイルは、プロセス B では無効になります。

4. プロセスの複製: サーバーが起動すると、メインプロセスが現在のプロセス状態を複製します。それ以降、プロセス内のデータは互いに独立しており、相互に影響を与えることはありません。

5. パブリック変数を書き込むためにコントローラーに基本クラスを作成しないでください。これはデータ汚染を引き起こします。次のリクエストが到着しても、この変数は引き続きリクエストされます。変数はメモリ内に常駐しているため、単純な興味がある場合、リリースされません。

公式ドキュメントにもヒントがあります

https://www.swoft.org/documents/v2/dev-guide/dev- note/

Swoft Frameworkインストール

インストール環境要件:

1. gcc のバージョンは、または4.8に等しい。

2. PHP バージョンは 7.1 以降です。

3. Composer パッケージ管理ツール。

4. Redis 非同期クライアント Hiiris をインストールします。これは、最新バージョンの Swoole4.2.6 以降にすでに組み込まれているため、インストールする必要はありません。

5. Swoole拡張機能、これは必要です。

6. イテレータ依存ライブラリ pcre をリンクします。

7. Swoole はコルーチンと非同期 Redis を有効にする必要があります。

インストール

git clone https://github.com/swoft-cloud/swoft
cd swoft
composer install
cp .env.example .env   #编辑 .env 文件，根据需要调整相关环境配置

ログイン後にコピー

次のエラーが発生した場合は、swft には redis 拡張機能が必要であるため、redis 拡張機能が利用できないことを意味します。

もちろん docker を使ったほうが簡単なので、以下のコマンドを実行します

docker run -p 18306:18306 --name swoft swoft/swoft

ログイン後にコピー

に http:/ と入力しますブラウザ /127.0.0.1:18306 は Swoft ローカルページを開くことができます。

実行中のコマンドを閉じて開始します docker start/stop swoft

Swoft ディレクトリとファイルの説明

コンテナに入って swoft ディレクトリを表示します

root@880c142615c3:/var/www/swoft# tree -L 2
.
|-- CONTRIBUTING.md
|-- Dockerfile
|-- LICENSE
|-- README.md
|-- README.zh-CN.md
|-- app                        #应用目录
|   |-- Annotation　　　　　　　 #定义注解相关目录|   |-- Application.php
|   |-- Aspect
|   |-- AutoLoader.php
|   |-- Common
|   |-- Console
|   |-- Exception
|   |-- Helper　　　　　　　　　　#助手函数目录
|   |-- Http
|   |-- Listener　　　　　　　　 #事件监听器目录|   |-- Migration
|   |-- Model　　　　　　　　　　 #模型、逻辑等代码目录|   |-- Process
|   |-- Rpc　　　　　　　　　　　　#RPC服务代码目录|   |-- Task　　　　　　　　　　　 #任务投递管理目录，这里可以做异步任务或者定时器的工作
|   |-- Tcp
|   |-- Validator
|   |-- WebSocket　　　　　　　　 #WebSocket服务代码目录|   `-- bean.php
|-- bin
|   |-- bootstrap.php
|   `-- swoft　　　　　　　　　　  #Swoft入口文件|-- composer.cn.json
|-- composer.json
|-- composer.lock
|-- config
|   |-- base.php
|   |-- db.php
|   `-- dev
|-- database
|   |-- AutoLoader.php
|   `-- Migration
|-- dev.composer.json
|-- docker-compose.yml
|-- phpstan.neon.dist
|-- phpunit.xml
|-- public
|   |-- favicon.ico
|   `-- image
|-- resource                   #应用资源目录|   |-- language
|   `-- views
|-- runtime　　　　　　　　　　   #临时文件目录（日志、上传文件、文件缓存等）|   |-- logs
|   |-- sessions
|   |-- swoft.command
|   `-- swoft.pid
|-- test　　　　　　　　　　　　　 #单元测试目录　　　
|   |-- apitest
|   |-- bootstrap.php
|   |-- run.php
|   |-- testing
|   `-- unit
`-- vendor
    |-- autoload.php
    |-- bin
    |-- composer
    |-- doctrine
    |-- monolog
    |-- myclabs
    |-- nikic
    |-- phar-io
    |-- php-di
    |-- phpdocumentor
    |-- phpoption
    |-- phpspec
    |-- phpunit
    |-- psr
    |-- sebastian
    |-- swoft
    |-- symfony
    |-- text
    |-- theseer
    |-- toolkit
    |-- vlucas
    `-- webmozart

ログイン後にコピー

SwoftBean コンテナ

Bean コンテナは Swoft の中核であり、各 Bean はクラスオブジェクトのインスタンス。コンテナは Bean を格納および管理するためのファクトリです。 HttpServer が起動すると、@Bean アノテーションを持つクラスがスキャンされます。従来の PHP には常駐メモリがありません。リクエストごとにさまざまなリソースが再初期化され、メモリを適用するには各オブジェクトを再インスタンス化する必要があります。リクエストが処理された後、リクエストは再び消費され、リソースの無駄になります。 Swoft は、HttpServer の起動後にこれらのオブジェクトをインスタンス化してメモリに保存し、次のリクエストで直接取り出して使用するため、オブジェクト作成リソースの消費が削減されます。

Beanコンテナの最下層はBeanFactory管理コンテナ(Container)です。

Swoft アノテーションメカニズム

アノテーションは、Swoft の多くの重要な機能、特に AOP および IoC コンテナーの基礎です。 Java に詳しい友人は、アノテーションについてもっと知っているはずです。

それでは、注釈とはどのようなものなのでしょうか?以下は Swoft のコード の一部です。 には、クラス、メソッド、またはメンバー変数の上のコメントセクションに注釈が付いています。

namespace App\Tcp\Controller;

use App\Tcp\Middleware\DemoMiddleware;
use Swoft\Tcp\Server\Annotation\Mapping\TcpController;
use Swoft\Tcp\Server\Annotation\Mapping\TcpMapping;
use Swoft\Tcp\Server\Request;
use Swoft\Tcp\Server\Response;
use function strrev;

/**
 * Class DemoController
 *
 * @TcpController(middlewares={DemoMiddleware::class})      #这个就是注解
 */
class DemoController
{
    /**
     * @TcpMapping("list", root=true)
     * @param Response $response
     */
    public function list(Response $response): void
    {
        $response->setData(&#39;[list]allow command: list, echo, demo.echo&#39;);
    }

ログイン後にコピー

　　注解是什么呢？有什么作用呢？

　　　　注解其实是通过反射把注释当成代码的一部分，PHP可以通过ReflectionClass来获取一个类的信息，从而了解类里的信息，比如获取类中的所有方法、成员变量，并包括私有方法等，并根据这些信息实现一些操作。像很多PHP框架，比如laravel框架就利用PHP的反射机制来实现依赖注入。

　　　　其实注解是配置的另一种方式，这里注解就可以起到一个配置作用。比如定义路由，定义配置定时任务，权限控制等。

　　　　在Swoft中要是使用注解，需引入相关注解（Annotation）类，且必须以 /** 开始并以 */ 结束，否则会导致无法解析！

Aop切面编程

　　Aop介绍

　　　　1. Aspect（切面）：通常是一个类，里面可以定义切入点和通知。

　　　　2. JointPoint（连接点）：程序执行过程中明确的点，一般是方法的调用。

　　　　3. Advice（通知）：Aop在特定的切入点执行的增强处理，有before，after，afterReturning，afterThrowing，around。

　　　　4. Pointcut（切入点）：就是嗲有通知的连接点，在程序中主要体现为书写切入点表达式。

　　 Swoft新版的Aop设计建立在PHP Parser上面。