Ubuntu如何安装Laravel框架

在 Ubuntu 上安装 Laravel 的完整步骤

一 准备环境

• 更新系统并安装必要工具与 PHP 扩展：
  • 命令：sudo apt update && sudo apt install -y php-cli php-mbstring php-curl php-xml php-bcmath php-zip unzip git curl
• 安装 Composer（PHP 依赖管理工具）：
  • 下载安装脚本并全局安装：
    • curl -sS https://getcomposer.org/installer | php
    • sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
  • 验证：composer --version
• 说明：Laravel 项目依赖 Composer 管理第三方库，以上扩展为常见必备项（不同版本可能略有差异）。

二 安装 Laravel 的两种方式

• 方式 A（推荐）使用 Laravel Installer 全局安装
  • 安装安装器：composer global require laravel/installer
  • 将 Composer 全局 bin 目录加入 PATH（示例为 Bash）：
    • echo ‘export PATH=$PATH:$HOME/.config/composer/vendor/bin’ >> ~/.bashrc
    • source ~/.bashrc
  • 创建项目：laravel new my_project
• 方式 B 使用 Composer 直接创建项目
  • 创建项目：composer create-project --prefer-dist laravel/laravel my_project
• 进入项目目录：cd my_project
• 说明：Installer 更便捷；create-project 更直接，适合无全局安装器场景。

三 配置数据库与运行

• 安装并初始化 MySQL（如尚未安装）：
  • sudo apt install -y mysql-server
  • sudo mysql_secure_installation
• 登录 MySQL 并创建数据库与用户（示例）：
  • mysql -u root -p
  • CREATE DATABASE my_database CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  • CREATE USER ‘my_user’@‘localhost’ IDENTIFIED BY ‘my_password’;
  • GRANT ALL PRIVILEGES ON my_database.* TO ‘my_user’@‘localhost’;
  • FLUSH PRIVILEGES; EXIT;
• 配置 Laravel 环境：
  • 复制环境文件：cp .env.example .env
  • 编辑 .env 数据库连接：
    • DB_CONNECTION=mysql
    • DB_HOST=127.0.0.1
    • DB_PORT=3306
    • DB_DATABASE=my_database
    • DB_USERNAME=my_user
    • DB_PASSWORD=my_password
• 生成应用密钥并迁移数据库：
  • php artisan key:generate
  • php artisan migrate
• 启动开发服务器：
  • php artisan serve
  • 访问：http://127.0.0.1:8000。

四 生产环境部署要点

• 使用 Nginx/Apache 作为 Web 服务器，指向项目的 public 目录，并配置 URL 重写（Laravel 路由需要）。
• 设置正确的文件权限（存储与缓存目录需可写），并优化自动加载与配置缓存：
  • php artisan config:cache
  • php artisan route:cache
  • php artisan view:cache
• 将 .env 加入版本控制忽略，生产环境使用独立环境配置与密钥。
• 建议通过 队列（Queue） 与 任务调度（Scheduler） 解耦耗时任务与定时任务。

五 常见问题与排查

• Composer 命令未找到：检查 PATH 是否包含 Composer 全局 bin 目录（如：~/.config/composer/vendor/bin），或重新执行 source 使其生效。
• 数据库连接失败：核对 .env 中 DB_* 配置、数据库是否创建、用户权限是否正确；必要时执行 php artisan config:clear 后重试。
• 目录权限错误：确保 storage、bootstrap/cache 对 Web 服务用户可写。
• 需要全新安装依赖：在项目根目录执行 composer install；如需更新依赖可使用 composer update（注意版本兼容）。