如何在PHP环境中使用Laravel？Laravel开发环境的搭建与配置-php教程-PHP中文网

在PHP环境中搭建Laravel需先安装PHP 8.1+及必要扩展，再安装Composer，通过它创建项目，配置.env文件并启动开发服务器。

如何在php环境中使用laravel？laravel开发环境的搭建与配置

在PHP环境中搭建和使用Laravel，核心在于准备好PHP运行环境、Composer依赖管理工具，以及一个合适的Web服务器，然后通过Composer创建并配置Laravel项目。这就像是为你的应用搭建一个坚实的地基，每一步都至关重要，但实际操作起来远比听起来要简单得多。

解决方案

要在PHP环境中使用Laravel，你需要依次完成以下步骤：

安装PHP及必要的扩展：确保你的系统安装了PHP 8.1或更高版本（根据你选择的Laravel版本而定），并启用了一些Laravel运行必需的扩展，如
```
mbstring
```
登录后复制
、
```
pdo
```
登录后复制
、
```
bcmath
```
登录后复制
、
```
fileinfo
```
登录后复制
、
```
json
```
登录后复制
、
```
xml
```
登录后复制
、
```
tokenizer
```
登录后复制
等。
安装Composer：Composer是PHP的包管理工具，Laravel项目的创建和依赖管理都离不开它。你需要全局安装Composer，以便在任何目录下都能使用其命令。
安装Web服务器：你可以选择Apache或Nginx来作为Web服务器，它们负责将用户请求路由到Laravel应用的
```
public
```
登录后复制
目录。当然，在本地开发时，Laravel自带的
```
php artisan serve
```
登录后复制
命令也能提供一个轻量级的开发服务器。
创建Laravel项目：使用Composer命令来创建一个全新的Laravel项目。
配置环境变量：新创建的Laravel项目会包含一个
```
.env
```
登录后复制
文件，你需要在这里配置数据库连接、应用名称、调试模式等关键信息。
运行迁移和Seeder（可选）：如果你的项目有数据库需求，运行数据库迁移和填充器来初始化数据库结构和数据。
启动开发服务器：通过
```
php artisan serve
```
登录后复制
命令或配置你的Web服务器来访问Laravel应用。

PHP版本选择与扩展配置：Laravel兼容性考量

我个人在选择PHP版本时，通常会倾向于使用最新的稳定版，但也会留意当前项目所依赖的Laravel版本对PHP的最低要求。比如，Laravel 10要求PHP 8.1及以上，而Laravel 11则需要PHP 8.2及以上。这种兼容性是开发前必须确认的，否则可能会遇到各种奇奇怪怪的错误，浪费不少时间去排查。

安装PHP时，除了核心组件，一些特定的扩展对Laravel的正常运行至关重要。我遇到过不少新手，包括我自己早年，因为缺少某个扩展导致应用无法启动或某些功能失效。例如，

php-mbstring

登录后复制

处理多字节字符串，

php-pdo

登录后复制

提供数据库抽象层，

php-bcmath

登录后复制

用于高精度数学运算，

php-fileinfo

登录后复制

用于文件上传的MIME类型检测，

php-json

登录后复制

、

php-xml

登录后复制

、

php-tokenizer

登录后复制

等也都是Laravel框架内部依赖的。

立即学习“PHP免费学习笔记（深入）”；

在Linux系统上，你可以通过包管理器（如

apt

登录后复制

或

yum

登录后复制

）安装这些扩展：

sudo apt update
sudo apt install php8.2-cli php8.2-common php8.2-mysql php8.2-mbstring php8.2-xml php8.2-bcmath php8.2-zip php8.2-gd php8.2-curl php8.2-fpm php8.2-sqlite3

登录后复制

安装后，还需要检查

php.ini

登录后复制

文件，确保

memory_limit

登录后复制

（比如设为512M或更高）和

max_execution_time

登录后复制

等参数满足应用需求。有时候，Composer在安装大型项目时，内存限制不足会导致安装失败。

Composer：Laravel项目依赖管理的核心利器

每次我开始一个新Laravel项目，Composer总是第一个要确认安装的工具，它简直就是PHP世界的“npm”或“pip”。没有Composer，手动管理Laravel及其数不清的第三方依赖几乎是不可能完成的任务。它不仅负责下载和安装所有项目依赖，还能处理版本冲突，并自动加载类文件，省去了我们手动

require

登录后复制

的麻烦。

全局安装Composer的步骤通常如下：

下载Composer安装器：

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

登录后复制

运行安装器：
```
php composer-setup.php
```
登录后复制
将
```
composer.phar
```
登录后复制
移动到系统路径下，使其成为全局命令：
```
sudo mv composer.phar /usr/local/bin/composer
```
登录后复制
验证安装：
```
composer -V
```
登录后复制

安装完成后，创建一个新的Laravel项目就变得异常简单：

composer create-project laravel/laravel my-project-name
cd my-project-name

登录后复制

这条命令会下载最新版本的Laravel框架，并自动安装所有必需的依赖。之后，如果需要添加新的库，比如一个图片处理库或一个API客户端，只需运行

composer require vendor/package-name

登录后复制

，Composer就会自动处理下载和配置。更新所有依赖则使用

composer update

登录后复制

。

Web服务器配置：Nginx与Apache的选择与优化

在选择Web服务器时，我个人更偏爱Nginx的轻量和高性能，尤其是在生产环境。它的事件驱动架构在高并发场景下表现出色。但在本地开发时，Apache的配置有时会更直观一些，特别是如果你已经习惯了

mod_rewrite

登录后复制

的规则。

多商户双网版电子商城CRMEB系统

基于ThinkPhp6+ swoole4+uniapp 开发的一套CRMEB新零售多商户商城系统。如果不会搭建请到查看搭建说明系统环境推荐使用宝塔配置环境centos PHP7.3 mysql5.6新增功能： 01·新增支持销售虚拟产品自动发货 02.支持销售链接与卡密可导入导出 03.自定义后台路径对后台进行保护 04.新增支持商家缴纳保证金功能 05·违法或侵权商品一键举报功能 06·仲

查看详情

Nginx配置示例： 创建一个新的Nginx站点配置文件（例如

/etc/nginx/sites-available/my-project-name.conf

登录后复制

）：

server {
    listen 80;
    server_name my-project-name.test; # 自定义域名，需要在hosts文件中映射
    root /var/www/my-project-name/public;

    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-XSS-Protection "1; mode=block";
    add_header X-Content-Type-Options "nosniff";

    index index.php index.html index.htm;

    charset utf-8;

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

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock; # 根据你的PHP-FPM版本调整
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}

登录后复制

然后，启用这个站点并重启Nginx：

sudo ln -s /etc/nginx/sites-available/my-project-name.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

登录后复制

Apache配置示例： 确保

mod_rewrite

登录后复制

模块已启用。在

httpd.conf

登录后复制

或独立的虚拟主机配置文件中添加：

<VirtualHost *:80>
    ServerName my-project-name.test
    DocumentRoot "/var/www/my-project-name/public"

    <Directory "/var/www/my-project-name/public">
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

登录后复制

重启Apache服务：

sudo systemctl restart apache2

登录后复制

对于本地开发，最简单的方式是直接在项目根目录运行Laravel自带的开发服务器：

php artisan serve

登录后复制

这会在

http://127.0.0.1:8000

登录后复制

启动一个轻量级服务器，非常适合快速测试和迭代。

数据库与环境变量：

.env

登录后复制

文件的艺术

.env

登录后复制

文件简直是Laravel的魔法盒，我总会提醒自己，千万不要把它提交到版本控制里（Git会自动忽略它，但意识上要记住）。它存储着应用在不同环境下的敏感配置信息，比如数据库凭据、API密钥、调试模式开关等。这使得同一个代码库可以在开发、测试和生产环境中使用不同的配置，而无需修改代码本身。

一个典型的

.env

登录后复制

文件可能包含以下内容：

APP_NAME="My Laravel App"
APP_ENV=local # 或 production, testing
APP_KEY=base64:someRandomStringGeneratedByLaravel

APP_DEBUG=true # 开发环境设为true，生产环境设为false

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

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

MAIL_MAILER=log
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}"

AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=
AWS_USE_PATH_STYLE_ENDPOINT=false

PUSHER_APP_ID=
PUSHER_APP_KEY=
PUSHER_APP_SECRET=
PUSHER_HOST=
PUSHER_PORT=443
PUSHER_SCHEME=https
PUSHER_APP_CLUSTER=mt1

登录后复制

每次修改

.env

登录后复制

文件后，有时需要清除配置缓存才能生效：

php artisan config:clear

登录后复制

当数据库配置完成后，就可以运行迁移来创建数据库表结构了：

php artisan migrate

登录后复制

如果需要填充一些初始数据，可以创建并运行Seeder：

php artisan db:seed

登录后复制

常见开发问题与调试技巧

在Laravel开发中，遇到问题是家常便饭，关键在于如何快速定位和解决。我记得有一次，我花了好几个小时才发现是

storage

登录后复制

目录权限没设好，那种挫败感真是...

1. 权限问题： Laravel需要对

storage

登录后复制

和

bootstrap/cache

登录后复制

目录有写入权限。如果遇到

Permission denied

登录后复制

错误，通常是这个原因。

sudo chmod -R 775 storage bootstrap/cache
sudo chown -R www-data:www-data storage bootstrap/cache # 适用于Apache/Nginx用户

登录后复制

2. Composer依赖安装失败： 网络问题、PHP内存限制不足或Composer缓存损坏都可能导致安装失败。

尝试清除Composer缓存：
```
composer clear-cache
```
登录后复制
增加PHP内存限制：修改
```
php.ini
```
登录后复制
中的
```
memory_limit
```
登录后复制
。

使用国内镜像源（如果网络环境不佳）：

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

登录后复制

.env

登录后复制

文件不生效： 有时修改了

.env

登录后复制

文件，但应用行为没有改变。这通常是因为配置被缓存了。

php artisan config:clear
php artisan cache:clear
php artisan view:clear

登录后复制

4. 数据库连接错误： 检查

.env

登录后复制

文件中的

DB_HOST

登录后复制

、

DB_PORT

登录后复制

、

DB_DATABASE

登录后复制

、

DB_USERNAME

登录后复制

、

DB_PASSWORD

登录后复制

是否正确。确保数据库服务正在运行，并且防火墙没有阻挡连接。

5. 调试技巧：

dd()
登录后复制
函数：Laravel提供了一个强大的
```
dd()
```
登录后复制
（dump and die）辅助函数，可以打印变量并终止脚本执行，是快速检查变量内容的利器。
日志文件：Laravel默认将错误和调试信息写入
```
storage/logs/laravel.log
```
登录后复制
。仔细阅读日志文件能提供宝贵的线索。
Xdebug：对于更复杂的调试，安装并配置Xdebug是必不可少的。它可以让你在IDE中设置断点，单步执行代码，查看调用栈和变量值。
Laravel Debugbar：这是一个强大的Composer包，可以在浏览器中显示各种调试信息，如查询、视图、路由、会话等。安装它：
```
composer require barryvdh/laravel-debugbar --dev
```
登录后复制
。