想修改 chcweb 出現的問題解決集

系列文章：
1.Ubuntu 24.04 安裝 chcweb 專案的過程記錄
2.Ubuntu 24.04 安裝 laravel 5.7 的過程記錄
3.laravel 5.7 初始相關設定與注意事項
4.想修改 chcweb 出現的問題解決集 

問題一: UnexpectedValueException : The stream or file "/home/webadmin/html/chcweb/storage/logs/laravel-2026-04-11.log" could not be opened in append mode: failed to open stream: Permission denied

解決方法:
錯誤意思是 Laravel 沒辦法寫入 log 檔，通常跟 目錄權限 有關。 

1.檢查檔案與目錄權限

Laravel 日誌檔案路徑：

/home/webadmin/html/chcweb/storage/logs/laravel-2026-04-16.log

需要 Web 伺服器用戶能夠寫入。通常 Linux 系統 Web 伺服器用戶是：

• Debian/Ubuntu：www-data
• CentOS/Fedora：apache 或 nginx

檢查目錄權限：

ls -l /home/webadmin/html/chcweb/storage/logs/
2.設定正確的擁有者
假設你的 Web 伺服器用戶是 www-data：
sudo chown -R www-data:www-data /home/webadmin/html/chcweb/storage

這樣 Web 伺服器就能寫入。
3.設定正確的權限
Laravel 需要 storage 和 bootstrap/cache 可寫：
sudo chmod -R 775 /home/webadmin/html/chcweb/storage
sudo chmod -R 775 /home/webadmin/html/chcweb/bootstrap/cache
775：擁有者與群組可讀寫執行，其他人可讀與執行
如果 775 仍然不行，可以暫時用 777 測試，但不建議長期使用（安全性較低） 
4.清除快取（可選）
Laravel 有時會快取檔案路徑，建議清除：
php artisan config:clear
php artisan cache:clear
然後再重新載入網站看看是否正常。
小技巧：
Laravel 的 storage 和 bootstrap/cache 目錄必須可寫，這是最常見的「Permission denied」原因。 

一行命令，直接安全地修復 Laravel 所有目錄的權限和擁有者，幾乎可以立即解決這種錯誤：

sudo chown -R www-data:www-data /home/webadmin/html/chcweb && sudo find /home/webadmin/html/chcweb/storage -type d -exec chmod 775 {} \; && sudo find /home/webadmin/html/chcweb/storage -type f -exec chmod 664 {} \; && sudo find /home/webadmin/html/chcweb/bootstrap/cache -type d -exec chmod 775 {} \; && sudo find /home/webadmin/html/chcweb/bootstrap/cache -type f -exec chmod 664 {} \; 

問題二：要在資料表setups 新增遺個欄位 bg_image


1.建立 Migration 


php artisan make:migration add_bg_image_to_setups_table --table=setups

2. 修改 Migration 檔案

<?php
use Illuminate\Support\Facades\Schema;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class AddBgImageToSetupsTable extends Migration {
  public function up() {
      Schema::table('setups', function (Blueprint $table) {
          $table->string('bg_image', 255)->nullable()->after('bg_color')->comment('背景圖片');
      }); 

}

  public function down() {
       Schema::table('setups', function (Blueprint $table) {
          $table->dropColumn('bg_image');
       });
    }
}

3.執行 Migration

php artisan migrate 

問題三： UnexpectedValueException  : The stream or file "/home/webadmin/html/chcweb/storage/logs/laravel-2026-04-17.log" could not be opened in append mode: failed to open stream: Permission denied

問題解析：這個錯誤是 Laravel 在寫 log 檔案時發生的權限問題，完全跟你新增欄位無關，但它會阻止 migration 或任何程式寫入日誌。解決方式是調整 storage 與 bootstrap/cache 的權限。

1.確認目錄

Laravel 需要以下目錄可讀寫：

• storage
• storage/logs
• storage/framework
• bootstrap/cache

 2.修改權限（Linux）

假設你的專案目錄是 /home/webadmin/html/chcweb：

cd /home/webadmin/html/chcweb
# 設定 owner 為 web server 使用者，通常是 www-data (Ubuntu/Debian) 或 apache/nginx
sudo chown -R webadmin:www-data storage bootstrap/cache
# 設定目錄可寫權限
sudo chmod -R 775 storage bootstrap/cache
＃注意：如果你的 web server 使用者不是 www-data，請改成實際使用者。

3.Laravel 快速清理快取（建議做）
php artisan config:clear
php artisan cache:clear
php artisan route:clear
php artisan view:clear
4. 測試
重新執行 migration：
php artisan migrate
如果權限設定正確，就不會再出現 Permission denied。
💡小技巧：
在開發環境中，設定 storage 和 bootstrap/cache 777（所有人可寫）雖然方便，但生產環境建議限制為 775 或更安全的方式，以免安全風險。 

 6.一行指令
既改權限，又保證 Laravel 的 storage 與 bootstrap/cache 可以被 web server 寫入，同時保持相對安全（775）

sudo chown -R webadmin:www-data /home/webadmin/html/chcweb/storage /home/webadmin/html/chcweb/bootstrap/cache && sudo chmod -R 775 /home/webadmin/html/chcweb/storage /home/webadmin/html/chcweb/bootstrap/cache 

問題四：   ErrorException  : file_put_contents(/home/webadmin/html/chcweb/database/migrations/2026_04_18_132842_add_bg_image_to_setups_table.php): failed to open stream: No such file or directory

問題解析：

這個錯誤訊息告訴我們 Laravel 無法寫入 migration 檔案，因為目標目錄不存在或沒有權限。重點在這兩件事：

1. 目錄 database/migrations 是否存在
2. 你的使用者是否有寫入權限

問題解答：

1.確認目錄存在

執行：

ls -ld /home/webadmin/html/chcweb/database/migrations

• 如果出現 No such file or directory，表示這個目錄真的不存在，需要建立：

mkdir -p /home/webadmin/html/chcweb/database/migrations

2.確認權限

Laravel 需要該目錄可寫入：

sudo chown -R webadmin:www-data /home/webadmin/html/chcweb/database/migrations
sudo chmod -R 775 /home/webadmin/html/chcweb/database/migrations

替換 webadmin 和 www-data 為你的實際使用者與 web server 群組。

3. 再次建立 migration

php artisan make:migration add_bg_image_to_setups_table --table=setups

這次 Laravel 就能成功在 database/migrations 產生檔案了。

💡 小提醒：

• storage、bootstrap/cache、database/migrations 都需要對 Laravel 可寫。
• 開發環境可以用 775，生產環境更安全的做法是限制非必要使用者寫入。
  

 4. 一次性指令：

把 Laravel 專案的 storage、bootstrap/cache、database/migrations 全部權限一次調整好。

sudo mkdir -p /home/webadmin/html/chcweb/database/migrations && sudo chown -R webadmin:www-data /home/webadmin/html/chcweb/storage /home/webadmin/html/chcweb/bootstrap/cache /home/webadmin/html/chcweb/database/migrations && sudo chmod -R 775 /home/webadmin/html/chcweb/storage /home/webadmin/html/chcweb/bootstrap/cache /home/webadmin/html/chcweb/database/migrations