下面按CentOS 系统环境,给你一套从零开始配置 Laravel 的常见做法(以 CentOS 7 / 8、PHP 7.4/8.x、Nginx 为例,Apache 也会顺带说明)。
sudo yum update -y
sudo yum install -y wget curl git unzip
sudo yum install -y https://rpms.remirepo.net/enterprise/remi-release-8.rpm
sudo dnf module reset php
sudo dnf module enable php:remi-8.1
sudo yum install -y php php-cli php-fpm php-mysqlnd \
php-zip php-gd php-mbstring php-curl php-xml php-bcmath
php -v
cd /tmp
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
sudo mv composer.phar /usr/local/bin/composer
composer --version
sudo yum install -y nginx
sudo systemctl enable --now nginx
cd /var/www
sudo composer create-project laravel/laravel example-app
sudo chown -R nginx:nginx /var/www/example-app
sudo chmod -R 755 /var/www/example-app
sudo chmod -R 777 /var/www/example-app/storage
编辑配置文件:
sudo vi /etc/nginx/conf.d/laravel.conf
示例配置:
server {
listen 80;
server_name your_domain_or_ip;
root /var/www/example-app/public;
index index.php index.html;
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;
}
location ~ /\.ht {
deny all;
}
}
重载 Nginx:
sudo nginx -t
sudo systemctl reload nginx
编辑:
sudo vi /etc/php-fpm.d/www.conf
确保:
user = nginx
group = nginx
listen = /run/php-fpm/www.sock
重启:
sudo systemctl restart php-fpm
cd /var/www/example-app
cp .env.example .env
php artisan key:generate
示例数据库配置(MySQL):
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=password
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --reload
sudo setsebool -P httpd_can_network_connect 1
sudo chcon -R -t httpd_sys_rw_content_t /var/www/example-app/storage
如果你用 Apache:
sudo yum install httpd
sudo systemctl enable --now httpd
启用 rewrite:
sudo vi /etc/httpd/conf/httpd.conf
AllowOverride All
| 问题 | 解决 |
|---|---|
| 500 错误 | 看 storage/logs/laravel.log |
| 权限问题 | storage 设 777 |
| 白屏 | 检查 PHP 版本 & 扩展 |
| 路由 404 | Nginx try_files 配置 |
如果你愿意,可以告诉我:
我可以直接给你精确配置方案。