如何安装CentOS下的Laravel

下面给你一份在 CentOS 上安装 Laravel 的完整流程，适用于 CentOS 7 / 8 / Stream，从系统环境到运行 Laravel 项目。

一、安装前的准备

1. 更新系统

sudo yum update -y

2. 安装常用工具

sudo yum install -y wget curl git unzip

二、安装 PHP（Laravel 依赖）

Laravel 对 PHP 版本有要求（以 Laravel 10 为例）：

Laravel 版本	PHP 版本
8.x	≥ 7.3
9.x	≥ 8.0
10.x	≥ 8.1
11.x	≥ 8.2

1. 添加 Remi 源（推荐）

sudo yum install -y epel-release
sudo yum install -y https://rpms.remirepo.net/enterprise/remi-release-7.rpm

2. 启用 PHP 8.2（示例）

sudo yum install -y yum-utils
sudo yum-config-manager --enable remi-php82

3. 安装 PHP 及扩展

sudo yum install -y php php-cli php-fpm php-json php-common \
php-mysql php-pgsql php-zip php-gd php-mbstring php-curl \
php-xml php-tokenizer php-fileinfo

4. 验证 PHP

php -v

三、安装 Composer（Laravel 依赖管理）

1. 下载并安装

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

2. 验证

composer -V

四、安装 Laravel

方式一：创建新项目（推荐）

composer create-project laravel/laravel example-app

进入目录：

cd example-app

启动内置服务器（测试用）：

php artisan serve --host=0.0.0.0 --port=8000

浏览器访问：

http://服务器IP:8000

方式二：全局安装 Laravel 安装器

composer global require laravel/installer

添加环境变量：

echo 'export PATH="$HOME/.config/composer/vendor/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

创建项目：

laravel new example-app

五、配置运行环境（生产环境推荐）

1. 安装 Nginx

sudo yum install -y nginx

2. 配置 Nginx

编辑配置：

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;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass   unix:/run/php-fpm/www.sock;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include        fastcgi_params;
    }
}

3. 设置权限

sudo chown -R nginx:nginx /var/www/example-app
sudo chmod -R 755 /var/www/example-app/storage

4. 启动服务

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

六、安装数据库（可选）

MySQL

sudo yum install -y mariadb mariadb-server
sudo systemctl start mariadb
sudo systemctl enable mariadb

配置数据库：

mysql_secure_installation

七、常见问题

1. 权限问题

sudo chmod -R 777 storage bootstrap/cache

2. Composer 很慢

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

3. PHP 扩展缺失

php -m

八、总结流程

✅ 更新系统
✅ 安装 PHP + 扩展
✅ 安装 Composer
✅ 安装 Laravel
✅ 配置 Nginx + PHP-FPM
✅ 配置数据库

如果你告诉我：

✅ CentOS 具体版本
✅ Laravel 版本
✅ 是否用于生产环境

我可以给你更精确的定制安装方案。