在Linux上如何使用ThinkPHP進行開發

在Linux上使用ThinkPHP進行開發的完整流程

一、環境準備：安裝基礎組件

ThinkPHP運行需PHP、Web服務器（Nginx/Apache）、數據庫（MySQL/MariaDB）、Composer四大組件，以下以Ubuntu/Debian為例說明安裝步驟（CentOS/RHEL替換為對應yum命令即可）：

1. 更新系統軟件包

   sudo apt update && sudo apt upgrade -y
   

2. 安裝PHP及必要擴展
   ThinkPHP 6.x推薦PHP 7.4及以上版本，需安裝核心擴展：

   sudo apt install php php-cli php-fpm php-mysql php-mbstring php-xml php-curl zip -y
   

3. 安裝Web服務器（以Nginx為例）

   sudo apt install nginx -y
   sudo systemctl start nginx && sudo systemctl enable nginx  # 啟動并設置開機自啟
   

4. 安裝Composer（PHP依賴管理工具）

   curl -sS https://getcomposer.org/installer | php
   sudo mv composer.phar /usr/local/bin/composer  # 全局可用
   

二、安裝ThinkPHP：推薦Composer創建項目

通過Composer創建項目可自動解決依賴問題，避免手動下載的麻煩：

cd /var/www/html  # 項目存放目錄（需web服務器有讀取權限）
composer create-project topthink/think tp6  # "tp6"為項目名稱，可自定義

等待安裝完成后，項目目錄結構會自動生成（包含public入口目錄、app應用目錄等）。

三、配置Web服務器：支持PHP與路徑重寫

1. Nginx配置（關鍵步驟）

創建專屬配置文件（避免修改默認配置導致沖突）：

sudo nano /etc/nginx/sites-available/tp6.conf

寫入以下內容（需修改root指向項目public目錄，這是ThinkPHP的安全要求）：

server {
    listen 80;
    server_name your_domain_or_ip;  # 替換為域名或IP
    root /var/www/html/tp6/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;  # 路徑重寫，支持路由
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;  # 根據PHP版本調整（如php7.4-fpm.sock）
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.ht {
        deny all;  # 禁止訪問.htaccess文件
    }
}

啟用配置并重啟Nginx：

sudo ln -s /etc/nginx/sites-available/tp6.conf /etc/nginx/sites-enabled/
sudo nginx -t  # 測試配置語法（無報錯則繼續）
sudo systemctl restart nginx

2. Apache配置（可選）

若使用Apache，需啟用mod_rewrite模塊并配置.htaccess：

sudo a2enmod rewrite
sudo systemctl restart apache2

在項目根目錄創建.htaccess文件：

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteRule ^(.*)$ public/$1 [L]
</IfModule>

四、配置數據庫：連接應用與數據

1. 創建數據庫與用戶
   登錄MySQL，執行以下命令：

   CREATE DATABASE tp6_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   CREATE USER 'tp6_user'@'localhost' IDENTIFIED BY 'your_password';
   GRANT ALL PRIVILEGES ON tp6_db.* TO 'tp6_user'@'localhost';
   FLUSH PRIVILEGES;
   

2. 修改項目數據庫配置
   編輯項目根目錄下的.env文件（覆蓋默認配置）：

   nano /var/www/html/tp6/.env
   

   找到[DATABASE]部分，修改為實際信息：

   DB_TYPE=mysql
   DB_HOST=127.0.0.1
   DB_NAME=tp6_db
   DB_USER=tp6_user
   DB_PASSWORD=your_password
   DB_PORT=3306
   

五、設置權限：避免文件訪問問題

確保web服務器用戶（如www-data）對項目目錄有正確權限：

sudo chown -R www-data:www-data /var/www/html/tp6  # 修改所有者
sudo chmod -R 755 /var/www/html/tp6/runtime       # 運行時目錄需可寫

六、運行項目：開發與測試

1. 啟動內置服務器（開發環境專用）
   進入項目目錄，運行以下命令啟動PHP內置服務器（端口8000，僅本地訪問）：

   cd /var/www/html/tp6
   php think run
   

   瀏覽器訪問http://your_domain_or_ip:8000，若看到ThinkPHP歡迎頁面，則說明環境配置成功。

2. 生產環境部署
   開發完成后，關閉調試模式（修改config/app.php中的app_debug為false），并通過Nginx/Apache提供正式服務。

七、常見問題排查

• 502 Bad Gateway：檢查PHP-FPM是否運行（sudo systemctl status php-fpm），確認Nginx配置中的fastcgi_pass路徑與PHP-FPM的socket路徑一致。
• 路由失效：確保Nginx配置中包含try_files $uri $uri/ /index.php?$query_string;（路徑重寫是ThinkPHP路由生效的關鍵）。
• Composer安裝慢：切換國內鏡像加速（composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/）。

通過以上步驟，即可在Linux系統上完成ThinkPHP的開發環境搭建與項目運行。開發過程中，可通過git進行版本控制，結合CI/CD工具實現自動化部署，提升開發效率。