CentOS ThinkPHP如何安裝配置

CentOS系統安裝配置ThinkPHP詳細步驟

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

在CentOS上部署ThinkPHP前，需先安裝Web服務器（Nginx/Apache）、PHP環境及Composer（ThinkPHP的依賴管理工具）。

• 更新系統包：

  sudo yum update -y
  

• 安裝Nginx（以Nginx為例，Apache步驟類似）：

  sudo yum install epel-release -y
  sudo yum install nginx -y
  sudo systemctl start nginx
  sudo systemctl enable nginx
  

• 安裝PHP及擴展（ThinkPHP 6.x需PHP 7.2+）：

  sudo yum install php php-fpm php-mysqlnd php-gd php-mbstring php-curl php-xml php-bcmath -y
  sudo systemctl start php-fpm
  sudo systemctl enable php-fpm
  

• 驗證PHP版本：

  php -v
  

  確保PHP版本符合ThinkPHP要求（如ThinkPHP 6.x需≥7.2）。

二、安裝Composer（ThinkPHP依賴管理工具）

ThinkPHP項目依賴Composer管理，需先全局安裝Composer：

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
sudo chmod +x /usr/local/bin/composer

驗證安裝：

composer --version

顯示Composer版本號則表示安裝成功。

三、部署ThinkPHP項目

1. 創建項目目錄

選擇項目存放路徑（如/var/www/html/thinkphp），并賦予適當權限：

sudo mkdir -p /var/www/html/thinkphp
sudo chown -R nginx:nginx /var/www/html/thinkphp  # 若使用Nginx，用戶為nginx
sudo chmod -R 755 /var/www/html/thinkphp

2. 使用Composer創建ThinkPHP項目

進入項目目錄，通過Composer創建ThinkPHP項目（以ThinkPHP 6.x為例）：

cd /var/www/html/thinkphp
composer create-project topthink/think tp6 --prefer-dist

等待Composer下載并安裝依賴（約幾分鐘）。

四、配置Web服務器（Nginx為例）

ThinkPHP需通過Web服務器訪問，需配置Nginx的重寫規則以支持PATHINFO（路由功能）。

• 創建Nginx配置文件：

  sudo vim /etc/nginx/conf.d/thinkphp.conf
  

• 添加以下配置（替換your_domain.com為域名/IP，/var/www/html/thinkphp/tp6/public為項目public目錄路徑）：

  server {
      listen 80;
      server_name your_domain.com;
      root /var/www/html/thinkphp/tp6/public;
      index index.php index.html index.htm;
  
      location / {
          try_files $uri $uri/ /index.php?$query_string;
      }
  
      location ~ \.php$ {
          fastcgi_pass unix:/run/php-fpm/www.sock;
          fastcgi_index index.php;
          include fastcgi_params;
          fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
          fastcgi_param PATH_INFO $fastcgi_path_info;
      }
  
      location ~ /\.ht {
          deny all;
      }
  }
  

• 測試Nginx配置：

  sudo nginx -t
  

  若顯示syntax is ok，則重啟Nginx：

  sudo systemctl restart nginx
  

Apache配置（可選）

若使用Apache，需啟用mod_rewrite模塊并創建虛擬主機：

sudo a2enmod rewrite
sudo systemctl restart apache2

虛擬主機配置參考Nginx的try_files規則，確保支持PATHINFO。

五、配置數據庫連接

ThinkPHP項目需連接數據庫（如MySQL），修改項目配置文件：

• 進入項目目錄：

  cd /var/www/html/thinkphp/tp6
  

• 復制.env.example為.env（隱藏配置文件）：

  cp .env.example .env
  

• 編輯.env文件，修改數據庫連接信息（替換為實際值）：

  DB_TYPE=mysql
  DB_HOST=127.0.0.1
  DB_NAME=your_database_name
  DB_USER=your_database_user
  DB_PASSWORD=your_database_password
  DB_PORT=3306
  DB_PREFIX=tp_
  

創建數據庫

登錄MySQL，創建數據庫和用戶：

mysql -u root -p

CREATE DATABASE your_database_name;
CREATE USER 'your_database_user'@'localhost' IDENTIFIED BY 'your_database_password';
GRANT ALL PRIVILEGES ON your_database_name.* TO 'your_database_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

六、設置目錄權限

確保項目目錄權限正確，避免訪問錯誤：

sudo chown -R nginx:nginx /var/www/html/thinkphp/tp6  # Nginx用戶
sudo chmod -R 755 /var/www/html/thinkphp/tp6
sudo chmod -R 775 /var/www/html/thinkphp/tp6/runtime  # runtime目錄需可寫

七、啟動項目并訪問

• 啟動PHP-FPM（若未啟動）：

  sudo systemctl start php-fpm
  sudo systemctl enable php-fpm
  

• 訪問項目：
  在瀏覽器輸入http://your_domain.com（或服務器IP），若看到ThinkPHP歡迎頁面，則部署成功。

常見問題排查

• 502 Bad Gateway：檢查PHP-FPM是否運行（sudo systemctl status php-fpm），確認Nginx配置中的fastcgi_pass路徑正確（如unix:/run/php-fpm/www.sock）。
• 路由失效：確保Nginx配置中包含try_files $uri $uri/ /index.php?$query_string;，支持PATHINFO。
• Composer安裝慢：使用國內鏡像加速（composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/）。

通過以上步驟，即可在CentOS系統上成功安裝配置ThinkPHP項目。