本書是我在多個真實的項目中用到的技術，會不斷的擴充或更新。由于 Thinkphp6 功能細節甚多，所以本書不能面面俱到，而是實錄了開發過程中可能遇到關鍵的問題，有了這些細枝末節，會對`Thinkphp6`有一個啟發。 ## ThinkPHP6 的運行環境 * PHP >= 7.1.0，兼容`PHP8.1` ### 安裝Composer 本項目同時在`Win10`、`Linux`和`Mac OS X`下開發，故列出`Thinkphp6`各平臺上的安裝步驟。 ### Linux 或 Mac OS命令行： Linux用戶不要使用`apt install composer`, 這樣安裝的是低版本的composer，請使用下面的命令行安裝最新版的composer。 ~~~ curl -sS https://getcomposer.org/installer | php sudo mv composer.phar /usr/local/bin/composer ~~~ ### Microsoft Windows 10： ~~~ php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');" php composer-setup.php php -r "unlink('composer-setup.php');" ~~~ 如果不習慣命令行安裝的話，可以到`composer`官網`https://getcomposer.org/download/`下載可視化軟件。 ### Mac OS： 除了使用命令行的方式安裝，也可以通過`brew install composer`安裝，當然這之前，你需要先按照`brew`（MacOS下軟件包管理工具）。`brew`的安裝方法見下。 ~~~ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)" ~~~ ### 更改安裝源： 如果你之后的命令操作很慢，可能是網絡不太好（大部分的軟件都在國外的服務器上），你可以采用下面的步驟，更改成國內的下載源。 打開命令行窗口（Microsoft Windows用戶）或控制臺（Linux、Mac 用戶）執行如下命令： ~~~ composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ ~~~ ### 安裝穩定版 在命令行下面，切換到`WEB`根目錄下面并執行下面的命令： ~~~ composer create-project topthink/think <project_dir> ~~~ 這里的`<project_dir>`就是要開發項目的根目錄，根據實際情況改寫。 安裝成功后會給出類似下面的提示。 ~~~ ... 此處省略 N 行... 12 package suggestions were added by new dependencies, use `composer suggest` to see details. Generating autoload files > @php think service:discover Succeed! > @php think vendor:publish Succeed! 6 packages you are using are looking for funding. Use the `composer fund` command to find out more! ~~~ ### 更新`ThinkPHP6` 如果之前已經安裝過，切換到項目的根目錄，執行： ~~~ composer update topthink/framework // 全部更新，務必備份好 `vendor` 目錄 composer update ~~~ 更新操作會覆蓋`thinkphp`核心目錄，但不會影響`app`目錄，因此不要在核心框架目錄之外編寫你的代碼或者放置第三方類庫。這可能會在以后的升級中被覆蓋。 ### 開發模式 在開發階段，在根目錄建立一個`.env`文件，內容參見`.example.env`，并開啟調試模式。上線部署后直接刪除`.env`文件即可。`.env`文件支持支持定義多個環境變量配置文件，配置文件命名規范為: ~~~ .env.example .env.testing .env.develop ~~~ 然后，需要在入口文件中指定部署使用的環境變量名稱： ~~~ // 執行HTTP應用并響應 $http = (new App())->setEnvName('develop')->http; $response = $http->run(); $response->send(); $http->end($response); ~~~ 調試模式的參數見下： ~~~ APP_DEBUG = true // 其余部分視情況可刪除 ~~~ 也可以使用命令操作，如下。 ~~~ cp .example.env .env ~~~ ### 測試運行及部署 在實際部署中，應該是綁定域名訪問到`public`目錄，安全起見，一定要確保其他目錄不在`WEB`目錄下面。下面給出`Nginx`的配置代碼，供參考。 ~~~ server { listen 80; server_name localhost; root /var/www/<project_name>/public; index index.html index.htm index.php; location / { if (!-e $request_filename) { //多入口需要配置多行 //rewrite /install.php(.*)$ /install.php?s=$1 last; rewrite ^(.*)$ /index.php?s=$1 last; break; } } location ~ \.php$ { fastcgi_pass 127.0.0.1:9000; #fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } } ~~~ 當看到瀏覽器出現如下信息，表示安裝成功。