如何在Ubuntu装Laravel

ubuntu

小樊

2026-09-28 17:36:10

栏目: 智能运维

在 Ubuntu 上安装 Laravel，通常分为 环境准备 → 安装 Composer → 安装 Laravel → 运行项目 几个步骤。下面以 Ubuntu 20.04 / 22.04 为例（PHP 8.1+）。

一、更新系统

sudo apt update
sudo apt upgrade -y

二、安装 PHP 及必要扩展

Laravel 10/11 需要 PHP 8.1 或以上。

sudo apt install -y php php-cli php-mbstring php-xml php-bcmath php-curl php-mysql php-zip unzip git

验证：

php -v

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

cd ~
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（如果还没加）：

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

可写入 ~/.bashrc 或 ~/.zshrc：

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

创建项目：

laravel new myapp

方式二：直接用 Composer 创建（更常用）

composer create-project laravel/laravel myapp

五、配置并运行 Laravel

cd myapp
cp .env.example .env
php artisan key:generate

本地运行（开发）：

php artisan serve

访问：

http://localhost:8000

六、（可选）使用 Nginx + MySQL 正式环境

如果你不是只本地测试，可以安装：

sudo apt install nginx mysql-server

Nginx 示例配置（简化）：

server {
    listen 80;
    server_name example.com;
    root /var/www/myapp/public;

    index index.php;

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

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

七、常见问题

✅ 权限问题

sudo chown -R $USER:www-data storage bootstrap/cache
chmod -R 775 storage bootstrap/cache

✅ Composer 慢

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

如果你告诉我：

Ubuntu 版本
是否用 Nginx / Apache
是否连接 MySQL

我可以给你更精确的一步步配置方案。