常見問題

如何處理靜態(tài)資源

Apache URl rewrite

<IfModule mod_rewrite.c>
  Options +FollowSymlinks
  RewriteEngine On
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-f
  # RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]  fcgi下無效
  RewriteRule ^(.*)$  http://127.0.0.1:9501/$1 [QSA,P,L]
   # 請開啟 proxy_mod proxy_http_mod request_mod
</IfModule>

Nginx URl rewrite

server {
    root /data/wwwroot/;
    server_name local.swoole.com;
    location / {
        proxy_http_version 1.1;
        proxy_set_header Connection "keep-alive";
        proxy_set_header X-Real-IP $remote_addr;
        if (!-f $request_filename) {
             proxy_pass http://127.0.0.1:9501;
        }
    }
}

Swoole 靜態(tài)文件處理器

詳細請可查看 配置文件 章節(jié)

修改配置文件的 dev.php 或者 produce.php，實現(xiàn) Swoole 對靜態(tài)文件進行處理。

<?php

return [
    // ...... 這里省略
    'MAIN_SERVER' => [
        // ...... 這里省略
        'SETTING' => [
            // ...... 這里省略

            # 設(shè)置處理 Swoole 靜態(tài)文件
            'document_root' => EASYSWOOLE_ROOT . '/Static/',
            'enable_static_handler' => true,
        ],
        // ...... 這里省略
    ],
    // ...... 這里省略
];

上述配置是假設(shè)你的項目根目錄有個 Static 目錄是用來放置靜態(tài)文件的。具體的使用可查看 https://wiki.swoole.com/#/http_server?id=document_root

關(guān)于跨域處理

在框架的初始化事件 initialize 事件 中進行注冊。

注冊示例代碼如下：

public static function initialize()
{
    date_default_timezone_set('Asia/Shanghai');

    // onRequest v3.4.x+
    \EasySwoole\Component\Di::getInstance()->set(\EasySwoole\EasySwoole\SysConst::HTTP_GLOBAL_ON_REQUEST, function (\EasySwoole\Http\Request $request, \EasySwoole\Http\Response $response) {
        $origin = $request->getHeader('origin')[0] ?? '*';
        $response->withHeader('Access-Control-Allow-Origin', $origin);
        $response->withHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
        $response->withHeader('Access-Control-Allow-Credentials', 'true');
        $response->withHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization, X-Requested-With, token');
        if ($request->getMethod() === 'OPTIONS') {
             $response->withStatus(\EasySwoole\Http\Message\Status::CODE_OK);
             return false;
        }
        return true;
    });
}

EasySwoole 3.4.x 版本之前：可在項目根目錄的 EasySwooleEvent.php 中看到 onRequest 及 afterRequest 方法.

如何獲取 $HTTP_RAW_POST_DATA

$content = $this->request()->getBody()->__toString();
$raw_array = json_decode($content, true);

如何獲取客戶端 IP

舉例，如何在控制器中獲取客戶端 IP

// 真實地址
// 獲取連接的文件描述符
$fd = $this->request()->getSwooleRequest()->fd;
$ip = \EasySwoole\EasySwoole\ServerManager::getInstance()->getSwooleServer()->connection_info($fd);
var_dump($ip);

// header 地址，例如經(jīng)過 nginx proxy 后
$ip2 = $this->request()->getHeaders();
var_dump($ip2);

HTTP 狀態(tài)碼總為500

自 swoole 1.10.x 和 2.1.x 版本起，執(zhí)行 http server 回調(diào)中，若未執(zhí)行 response->end()，則全部返回 500 狀態(tài)碼

如何 setCookie

調(diào)用 response 對象的 setCookie 方法即可設(shè)置 cookie。setCookie 方法和原生 setcookie 用法一致。

$this->response()->setCookie('name', 'value');

更多操作可看 Response 對象

如何自定義 App 命名空間對應(yīng)目錄

只需要修改項目根目錄的 composer.json 的自動加載的 App 命名空間對應(yīng)的目錄即可，然后執(zhí)行 composer dumpautolaod -o 注冊就行。

{
    // ... 這里省略
    "autoload": {
        "psr-4": {
            "App\\": "Application/"
        }
    }
}

如何啟用 Https

通常建議使用 Nginx 或者 Lb 來配置證書，將 https 請求解析為 http 反代到 swoole

如果你僅是測試使用，可以在配置文件 (dev.php 或者 produce.php) 中添加和修改以下配置來啟用https。

<?php

return [
    // ...... 這里省略
    'MAIN_SERVER' => [
        // ...... 這里省略
        'SOCK_TYPE' => SWOOLE_TCP | SWOOLE_SSL, // 默認是 SWOOLE_TCP
        'SETTING' => [
            'ssl_cert_file' => '證書路徑，僅支持.pem格式',
            'ssl_key_file' => '私鑰路徑',
        ]
        // ...... 這里省略
    ],
    // ...... 這里省略
];

詳細請可查看 配置文件 章節(jié)

DNS Lookup resolve timeout 錯誤

該錯誤一般存在于 http 客戶端并發(fā)調(diào)用時產(chǎn)生，原因是 dns 效率慢，導(dǎo)致多線程獲取 dns 時超時，包括不限于以下場景:

• mysql host 設(shè)置為域名形式，并且設(shè)置最小連接高于 2(很難看到，一般是 10 才會偶爾報錯)
• HTTPClient 多個協(xié)程同時并發(fā)
• csp 并發(fā)編程 等

例如:

Swoole\Coroutine::gethostbyname('www.baidu.com');
for ($j = 0; $j < 100; $j++) {
    go(function () use ($j) {
        for ($i = 0; $i < 1000; $i++) {
            $client = new Swoole\Coroutine\Http\Client('www.baidu.com', 443, true);
            $client->get('/');
            if (empty($client->errMsg)) {
//var_dump($client->getBody());
            } else {
                var_dump($client->errMsg);
            }
        }
    });
}

CURL 發(fā)送 POST請求 EasySwoole 服務(wù)器端超時

• 出現(xiàn)原因：CURL 在發(fā)送較大的 POST 請求(例如: 上傳文件)時會先發(fā)一個 100-continue 的請求，如果收到服務(wù)器的回應(yīng)才會發(fā)送實際的 POST 數(shù)據(jù)。而 swoole_http_server(即 EasySwoole 的 Http 主服務(wù)) 不支持 100-continue，就會導(dǎo)致 CURL 請求超時。
• 解決方法：

方法1：關(guān)閉 CURL 的 100-continue，在 CURL 的 Header 中配置關(guān)閉 100-continue 選項。

示例代碼(php):

<?php
// 創(chuàng)建一個新cURL資源
$ch = curl_init();
// 設(shè)置URL和相應(yīng)的選項
curl_setopt($ch, CURLOPT_URL, "http://127.0.0.1:9501");
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_POST, 1); // 設(shè)置為POST方式
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Expect:')); // 關(guān)閉 `CURL` 的 `100-continue`
curl_setopt($ch, CURLOPT_POSTFIELDS, array('test' => str_repeat('a', 800000)));// POST 數(shù)據(jù)
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

方法2：使用 Nginx 做前端代理，由 Nginx 處理 100-Continue(針對無法關(guān)閉 100-continue時)

http 服務(wù)中公共函數(shù)如何引入

很多開發(fā)小伙伴在開發(fā)過程中可能遇到疑惑，在 EasySwoole 怎么像 ThinkPHP 框架那樣引入自定義的公共函數(shù)，接下來簡單說明下引入方法，這邊推薦借助 composer 的自動加載機制 （Files）實現(xiàn)。

修改項目根目錄的 composer.json 文件的 autoload.files 選項，示例如下：

{
    // ... 這里省略
    "autoload": {
        // ... 這里省略
        "files": ["App/Common/functions.php"]
    }
}

然后新建文件 App\Common\functions.php，在 functions.php 中編寫自己的自定義函數(shù)，再在項目根目錄執(zhí)行 composer dumpautoload 完成自動加載，就可以在框架的任意位置進行調(diào)用函數(shù)了。

示例如下：

<?php
// functions.php
if (!function_exists('helloEasySwoole')) {
    function helloEasySwoole()
    {
        echo 'Hello EasySwoole!';
    }
}

// ... 更多自定義函數(shù)

調(diào)用示例：

<?php
namespace App\HttpController;

use EasySwoole\Http\AbstractInterface\Controller;

class Index extends Controller
{
    function index()
    {
        \helloEasySwoole();
    }
}

自定義函數(shù)都可以放在這個文件中。