centos laravel部署有哪些注意事項

CentOS部署Laravel的注意事項

1. PHP版本與擴展要求

Laravel需要PHP 7.3及以上版本，需提前通過yum安裝PHP及必要擴展（如php-mysqlnd、php-gd、php-mbstring、php-curl、php-xml、php-bcmath）。若版本不符，可通過Remi倉庫升級PHP（如sudo yum-config-manager --enable remi-php74安裝PHP 7.4）。

2. Composer依賴管理

使用Composer安裝Laravel及依賴（composer create-project --prefer-dist laravel/laravel your_project_name）。部署后需運行composer install安裝項目依賴，若內存不足可臨時增加限制（php -d memory_limit=256M composer install）。

3. Web服務器配置

• Nginx：需配置root指向項目public目錄，添加try_files $uri $uri/ /index.php?$query_string規則處理路由，并配置PHP-FPM（fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock）。示例配置：

  server {
      listen 80;
      server_name yourdomain.com;
      root /path/to/your/laravel-project/public;
      index index.php index.html;
      location / { try_files $uri $uri/ /index.php?$query_string; }
      location ~ \.php$ {
          fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;
          fastcgi_index index.php;
          include fastcgi_params;
          fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
      }
  }
  

• Apache：需啟用mod_rewrite模塊，配置DocumentRoot指向public目錄，并設置AllowOverride All允許.htaccess重寫規則。

4. 文件權限設置

• 將項目目錄所有者改為Web服務器用戶（nginx或apache）：sudo chown -R nginx:nginx /path/to/your/laravel-project。
• 設置目錄權限為755、文件權限為644：

  sudo find /path/to/your/laravel-project -type d -exec chmod 755 {} \;
  sudo find /path/to/your/laravel-project -type f -exec chmod 644 {} \;
  

• 特別注意storage和bootstrap/cache目錄需可寫（chmod -R 755），確保Laravel能寫入緩存、日志等文件。

5. SELinux配置

若系統啟用SELinux，需調整上下文或臨時禁用：

• 臨時禁用：sudo setenforce 0（重啟后恢復）。
• 永久禁用：編輯/etc/selinux/config，將SELINUX=enforcing改為SELINUX=disabled。
• 或設置正確上下文：sudo chcon -R -t httpd_sys_content_t /path/to/your/laravel-project。

6. 環境配置

• 復制.env.example為.env：cp .env.example .env。
• 修改數據庫連接（DB_CONNECTION、DB_HOST、DB_DATABASE、DB_USERNAME、DB_PASSWORD）及其他配置（如APP_KEY）。
• 生成應用密鑰：php artisan key:generate。
• 清除配置緩存：php artisan config:clear。

7. 日志與錯誤排查

• 查看Laravel日志（storage/logs/laravel.log）定位錯誤：tail -f /path/to/your/laravel-project/storage/logs/laravel.log。
• 檢查Web服務器錯誤日志（Nginx：/var/log/nginx/error.log；Apache：/var/log/httpd/error_log）。

8. 性能優化（可選）

• 開啟配置緩存：php artisan config:cache。
• 開啟路由緩存：php artisan route:cache。
• 開啟視圖緩存：php artisan view:cache（生產環境建議開啟）。