10.3K 136 838

Đã đăng vào Thứ Hai, 2:40 SA 4 phút đọc

Khắc phục triệt để lỗi "file_put_contents(...): Failed to open stream: Permission denied" trong Laravel

1. Bối cảnh xuất hiện lỗi (Context)

Lỗi này thường xuyên xuất hiện nhất trong các trường hợp sau:

Lần đầu tiên clone một project Laravel từ Github/Gitlab về máy và chạy thử.
Đưa (deploy) dự án Laravel từ máy tính cá nhân (localhost) lên máy chủ thật (VPS/Server) chạy hệ điều hành Linux (Ubuntu, CentOS,...).
Sau khi bạn chạy các lệnh như php artisan config:cache hoặc php artisan view:cache bằng quyền root trên server.

Thông báo lỗi chi tiết thường có dạng:

ErrorException
file_put_contents(/var/www/html/storage/framework/views/...): Failed to open stream: Permission denied

2. Giải thích chi tiết lỗi là gì?

Thông báo lỗi này bao gồm 2 phần chính đến từ PHP:

file_put_contents(): Đây là một hàm trong PHP được sử dụng để ghi dữ liệu vào một file.
Failed to open stream: Permission denied: PHP báo rằng nó không thể mở tệp tin để ghi dữ liệu vì bị hệ điều hành từ chối quyền (Permission denied).

Tại sao Laravel lại cần ghi file? Khi bạn sử dụng Blade Template (các file .blade.php), Laravel không chạy trực tiếp các file này. Thay vào đó, nó sẽ biên dịch (compile) các file Blade này thành các file PHP thuần và lưu vào thư mục storage/framework/views/ để tăng tốc độ phản hồi cho những lần truy cập sau. Nếu hệ thống không cho phép Laravel ghi file vào thư mục này, ứng dụng sẽ ngay lập tức "chết" và quăng ra lỗi trên.

3. Nguyên nhân gây ra lỗi

Nguyên nhân gốc rễ là do sự bất đồng bộ về quyền sở hữu (Ownership) và phân quyền (Permissions) trên hệ điều hành Linux.

Khi web chạy, nó được thực thi bởi một user của Web Server (ví dụ: Apache và Nginx trên Ubuntu thường dùng user là www-data).
Tuy nhiên, các thư mục như storage hay bootstrap/cache trong dự án của bạn lại đang thuộc quyền sở hữu của một user khác (ví dụ: root hoặc user cá nhân của bạn), và các thư mục này không mở quyền "Ghi" (Write) cho các user khác.
Kết quả: Web Server (www-data) không thể ghi file vào thư mục của root -> Phát sinh lỗi Permission denied.

4. Hướng dẫn cách khắc phục chi tiết (Dành cho Server Linux)

Để giải quyết triệt để vấn đề này, bạn cần cấp quyền sở hữu thư mục cho Web Server và cấu hình quyền đọc/ghi phù hợp. Mở Terminal (hoặc kết nối SSH vào VPS) và thực hiện các bước sau:

Bước 1: Di chuyển vào thư mục dự án

Đảm bảo bạn đang đứng ở thư mục gốc chứa mã nguồn Laravel (Ví dụ: /var/www/html).

cd /var/www/html

Bước 2: Chuyển quyền sở hữu (Ownership) cho Web Server

Bạn cần đổi chủ sở hữu của 2 thư mục storage và bootstrap/cache sang cho user của Web Server (ở đây ví dụ là www-data trên Ubuntu/Debian).

sudo chown -R www-data:www-data storage
sudo chown -R www-data:www-data bootstrap/cache

(Lưu ý: Nếu bạn dùng CentOS/RHEL, user của web server thường là apache hoặc nginx).

Bước 3: Cấp quyền Đọc - Ghi - Thực thi (Permissions)

Thiết lập quyền 775 (hoặc 755) để đảm bảo Web Server có đủ quyền thao tác với file bên trong.

sudo chmod -R 775 storage
sudo chmod -R 775 bootstrap/cache

Bước 4: Dọn dẹp Cache (Khuyên dùng)

Sau khi cấp quyền xong, hãy xóa các cache cũ bị kẹt lại bằng các lệnh Artisan:

php artisan optimize:clear

Lệnh này sẽ tự động xóa cache của view, config, route và cache hệ thống.

💡 Mẹo nhỏ (Pro Tips) giúp tránh lỗi về sau:

Đừng bao giờ chạy lệnh php artisan bằng user root nếu bạn có thể chạy bằng user của ứng dụng. Nếu bạn chạy php artisan cache:clear bằng root, các file cache mới sinh ra sẽ thuộc về root, và web server lại tiếp tục không đọc/ghi được.
Nếu dùng CentOS / RedHat, lỗi này đôi khi do SELinux chặn. Bạn cần chạy thêm lệnh sau để cho phép HTTPD ghi vào thư mục:

chcon -Rt httpd_sys_rw_content_t storage

Chúc các bạn khắc phục lỗi thành công và có những trải nghiệm tuyệt vời với Laravel!