安装与配置 #

一、环境要求 #

1.1 服务器要求 #

Laravel 11.x 对服务器有以下要求：

要求	版本
PHP	>= 8.2
Composer	>= 2.0
扩展	OpenSSL, PDO, Mbstring, Tokenizer, XML, Ctype, JSON, BCMath

1.2 PHP扩展检查 #

bash

# 检查PHP版本
php -v

# 检查已安装扩展
php -m

# 检查特定扩展
php -m | grep openssl
php -m | grep pdo
php -m | grep mbstring

1.3 必需扩展说明 #

扩展	说明
OpenSSL	加密支持
PDO	数据库抽象层
Mbstring	多字节字符串处理
Tokenizer	代码解析
XML	XML处理
Ctype	字符类型检测
JSON	JSON处理
BCMath	任意精度数学运算
FileInfo	文件信息检测

二、安装Laravel #

2.1 通过Composer创建项目 #

bash

# 创建新项目
composer create-project laravel/laravel example-app

# 进入项目目录
cd example-app

# 启动开发服务器
php artisan serve

2.2 通过Laravel安装器 #

bash

# 全局安装Laravel安装器
composer global require laravel/installer

# 创建新项目
laravel new example-app

# 进入项目目录并启动
cd example-app
php artisan serve

2.3 安装完成后 #

text

访问: http://localhost:8000
看到Laravel欢迎页面表示安装成功

三、开发环境 #

3.1 Laravel Sail (Docker) #

Laravel Sail是Laravel官方提供的Docker开发环境：

bash

# 在项目目录安装Sail
php artisan sail:install

# 启动Sail
./vendor/bin/sail up

# 后台运行
./vendor/bin/sail up -d

# 停止Sail
./vendor/bin/sail down

常用Sail命令：

bash

# 运行Artisan命令
./vendor/bin/sail artisan migrate

# 运行Composer
./vendor/bin/sail composer install

# 运行npm
./vendor/bin/sail npm run dev

# 运行测试
./vendor/bin/sail test

3.2 Laravel Herd (推荐) #

Herd是现代化的本地开发环境，支持macOS和Windows：

text

特点：
- 一键安装PHP和Composer
- 自动管理多PHP版本
- 内置dnsmasq支持.test域名
- 图形界面管理服务
- 支持Valet和Sail项目

3.3 Laravel Valet (macOS) #

Valet是极简的macOS开发环境：

bash

# 安装Valet
composer global require laravel/valet

# 运行安装
valet install

# 设置项目目录
cd ~/Sites
valet park

# 链接单个项目
valet link

# 访问项目
# http://example-app.test

3.4 Laragon (Windows) #

Laragon是Windows平台的开发环境：

text

特点：
- 自动配置虚拟主机
- 一键切换PHP版本
- 内置MySQL、Redis
- 支持自动SSL
- 轻量高效

四、项目配置 #

4.1 环境配置文件 #

Laravel使用.env文件管理环境配置：

env

# .env 文件示例

APP_NAME=Laravel
APP_ENV=local
APP_KEY=
APP_DEBUG=true
APP_URL=http://localhost

LOG_CHANNEL=stack
LOG_DEPRECATIONS_CHANNEL=null
LOG_LEVEL=debug

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

BROADCAST_DRIVER=log
CACHE_DRIVER=file
FILESYSTEM_DISK=local
QUEUE_CONNECTION=sync
SESSION_DRIVER=file
SESSION_LIFETIME=120

MEMCACHED_HOST=127.0.0.1

REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

MAIL_MAILER=smtp
MAIL_HOST=mailpit
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="hello@example.com"
MAIL_FROM_NAME="${APP_NAME}"

4.2 生成应用密钥 #

bash

# 生成应用密钥
php artisan key:generate

# 这会自动设置APP_KEY

4.3 配置缓存 #

bash

# 缓存配置（生产环境）
php artisan config:cache

# 清除配置缓存
php artisan config:clear

五、数据库配置 #

5.1 MySQL配置 #

env

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password

5.2 SQLite配置 #

env

DB_CONNECTION=sqlite
# 数据库文件位于 database/database.sqlite

bash

# 创建SQLite数据库文件
touch database/database.sqlite

5.3 PostgreSQL配置 #

env

DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password

5.4 数据库连接测试 #

bash

# 运行迁移测试连接
php artisan migrate

六、目录权限 #

6.1 设置存储目录权限 #

bash

# 设置storage和bootstrap/cache目录可写
chmod -R 775 storage
chmod -R 775 bootstrap/cache

# 或设置所有者
chown -R www-data:www-data storage
chown -R www-data:www-data bootstrap/cache

6.2 目录结构权限 #

text

需要可写权限的目录：
├── storage/
│   ├── app/
│   ├── framework/
│   └── logs/
└── bootstrap/cache/

七、调试配置 #

7.1 开启调试模式 #

env

APP_DEBUG=true

注意：生产环境必须设置为false！

7.2 Laravel Debugbar #

bash

# 安装Debugbar
composer require barryvdh/laravel-debugbar --dev

7.3 错误页面 #

Laravel提供了美观的错误页面：

php

// 自定义错误页面
// resources/views/errors/404.blade.php
// resources/views/errors/500.blade.php

八、常用Artisan命令 #

8.1 基础命令 #

bash

# 查看所有命令
php artisan list

# 查看帮助
php artisan help make:controller

# 查看Laravel版本
php artisan --version

# 进入交互模式
php artisan tinker

8.2 开发命令 #

bash

# 启动开发服务器
php artisan serve

# 指定端口
php artisan serve --port=8080

# 指定主机
php artisan serve --host=0.0.0.0

8.3 缓存命令 #

bash

# 清除应用缓存
php artisan cache:clear

# 清除配置缓存
php artisan config:clear

# 清除路由缓存
php artisan route:clear

# 清除视图缓存
php artisan view:clear

# 清除所有缓存
php artisan optimize:clear

九、Composer使用 #

9.1 安装依赖 #

bash

# 安装所有依赖
composer install

# 生产环境安装（不安装开发依赖）
composer install --no-dev

# 优化自动加载
composer dump-autoload --optimize

9.2 更新依赖 #

bash

# 更新所有依赖
composer update

# 更新单个包
composer update laravel/framework

# 更新到最新版本
composer update --with-all-dependencies

十、总结 #

10.1 安装检查清单 #

检查项	命令
PHP版本	`php -v`
扩展安装	`php -m`
Composer	`composer -V`
项目创建	`laravel new` 或 `composer create-project`
密钥生成	`php artisan key:generate`
数据库连接	`php artisan migrate`
开发服务器	`php artisan serve`

10.2 下一步 #

环境搭建完成后，让我们了解目录结构，深入理解Laravel项目的组织方式！