温馨提示×

如何在Debian上装Laravel

小樊
53
2026-10-08 03:59:28
栏目: 智能运维

下面是在 Debian(如 Debian 11 / 12) 上安装并运行 Laravel 的一套常见、稳妥流程。以 Laravel 10/11 + PHP 8.1/8.2 + Nginx/Apache + MySQL 为例。


一、更新系统

sudo apt update
sudo apt upgrade -y

二、安装 PHP 及必要扩展

Laravel 需要 PHP 及常用扩展:

sudo apt install -y php php-cli php-fpm php-mysql php-mbstring php-xml php-bcmath php-curl php-zip php-gd php-intl

检查 PHP 版本:

php -v

Laravel 10 需要 PHP ≥ 8.1
Laravel 11 需要 PHP ≥ 8.2


三、安装 Composer(Laravel 依赖管理工具)

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

验证:

composer -V

四、安装 Laravel

方式一:使用 Laravel 安装器(推荐)

composer global require laravel/installer

添加到 PATH(编辑 ~/.bashrc 或 ~/.profile):

export PATH="$HOME/.composer/vendor/bin:$PATH"

重新加载:

source ~/.bashrc

创建项目:

laravel new myapp

方式二:直接用 Composer 创建(更简单)

composer create-project laravel/laravel myapp

五、配置权限

cd myapp
chown -R www-data:www-data storage bootstrap/cache
chmod -R 775 storage bootstrap/cache

六、配置 Web 服务器(以 Nginx 为例)

1. 安装 Nginx

sudo apt install -y nginx

2. 配置站点

sudo nano /etc/nginx/sites-available/myapp

示例配置:

server {
    listen 80;
    server_name your_domain_or_ip;
    root /var/www/myapp/public;

    index index.php index.html;

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

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php-fpm.sock;
    }

    location ~ /\.ht {
        deny all;
    }
}

启用站点:

sudo ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

七、配置数据库(MySQL 示例)

sudo apt install -y mysql-server
sudo mysql_secure_installation

创建数据库:

CREATE DATABASE laravel;
CREATE USER 'laravel'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON laravel.* TO 'laravel'@'localhost';
FLUSH PRIVILEGES;

编辑 .env:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=password

八、运行 Laravel

php artisan key:generate
php artisan migrate

本地开发可用:

php artisan serve

访问:

http://localhost:8000

九、常见问题

  • Permission denied:检查 storage 权限
  • Class not found:运行 composer dump-autoload
  • 502 Bad Gateway:检查 PHP-FPM 是否运行

如果你愿意,我可以按你的 Debian 版本 / Web 服务器(Nginx 或 Apache)/ 是否用 Docker 给你一份更精确的教程。

0 踩