PHP 基於 Swoole 實作高效安全 FTP 服務器（一）

PHP 基於 Swoole 實作高效安全 FTP 服務器（一）

傳統 FTP 服務器軟體功能固定、難以二次開發、付費版昂貴。利用 PHP Swoole 擴展的異步非阻塞 TCP 服務器能力，可快速構建功能可完全定制的 FTP 服務器。本系列文章將逐步實現。

Swoole 核心優勢

• 內建異步非阻塞、多執行緒/多進程網路 IO 服務器
• PHP 程式設計師僅需處理事件回調，無需關心底層
• 支援同步/異步混合編程，開發效率極高
• 廣泛應用於即時通訊、遊戲、物聯網、企業軟體等領域

專案目標功能

專案目錄結構

FtpServer/
├── conf/
│   ├── config.php      # FTP 配置文件
│   ├── ssl.crt         # SSL 證書
│   └── ssl.key         # SSL 私鑰
├── inc/
│   ├── CSmtp.php       # SMTP 郵件類（密碼發送/重置）
│   ├── ShareMemory.php # 共享記憶體操作類
│   └── User.php        # 用戶/權限/IP 控制核心
├── logs/               # 日誌文件
├── reference/          # 參考文檔
├── web/
│   ├── wwwroot/        # Web 管理站點
│   └── CWebServer.php  # 內建 HTTP 服務器
├── CFtpServer.php      # FTP 服務器主程序
└── MyFtpServer.php     # 入口程式

實施步驟規劃

1. 環境準備：CentOS 7、PHP 7.1+、Swoole 4.x（pecl install swoole）
2. 字符集處理：建議系統字符集設為 GB18030，與 Windows 客戶端相容，避免中文檔名亂碼
3. 核心協議實作：RFC 959 FTP 指令解析（USER、PASS、PORT、PASV、RETR、STOR、LIST、DELE、RNFR、RNTO、MKD、RMD、PWD、CWD、TYPE、MODE、STRU、QUIT）
4. 被動模式 (PASV) 數據連接：動態端口範圍配置、防火牆穿透
5. SSL 整合：stream_socket_enable_crypto() 升級控制連接、數據連接加密
6. 虛擬文件系統：映射邏輯路徑到物理路徑、權限檢查、配額執行
7. Web 管理介面：Swoole HTTP Server 提供 REST API + Vue/React 前端

關鍵技術點預告

// Swoole TCP Server 基礎骨架
$server = new Swoole\Server('0.0.0.0', 21, SWOOLE_PROCESS, SWOOLE_SOCK_TCP);
$server->set([
  'worker_num' => 4,
  'max_request' => 10000,
  'dispatch_mode' => 2,
  'daemonize' => true,
  'log_file' => '/var/log/ftp_server.log',
]);

$server->on('Connect', function ($server, $fd) {
  $server->send($fd, "220 Welcome to Custom FTP Server\r\n");
});

$server->on('Receive', function ($server, $fd, $reactor_id, $data) {
  // 解析 FTP 指令
  // 狀態機處理：未登入 -> 已登入 -> 數據傳輸
  // 指令分發：USER, PASS, SYST, FEAT, PWD, TYPE, PASV, PORT, LIST, RETR, STOR...
});

$server->on('Close', function ($server, $fd) {
  // 清理會話資源、關閉數據連接
});

$server->start();

為何選擇 PHP + Swoole？

系列規劃：本文為架構設計篇，後續將分篇實作：協議解析器、虛擬文件系統、認證授權體系、SSL/FTPS、被動模式數據通道、Web 管理介面、壓力測試與優化。歡迎持續關注。