在PHP环境中搭建Laravel需先安装PHP 8.1+及必要扩展，再安装Composer，通过它创建项目，配置.env文件并启动开发服务器。
在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 updatesudo 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-namecd my-project-name
这条命令会下载最新版本的Laravel框架，并自动安装所有必需的依赖。之后，如果需要添加新的库，比如一个图片处理库或一个API客户端，只需运行
composer require vendor/package-name
，Composer就会自动处理下载和配置。更新所有依赖则使用
composer update
。
Web服务器配置：Nginx与Apache的选择与优化
在选择Web服务器时，我个人更偏爱Nginx的轻量和高性能，尤其是在生产环境。它的事件驱动架构在高并发场景下表现出色。但在本地开发时，Apache的配置有时会更直观一些，特别是如果你已经习惯了
mod_rewrite
的规则。
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 -tsudo systemctl restart nginx
Apache配置示例：确保
mod_rewrite
模块已启用。在
httpd.conf
或独立的虚拟主机配置文件中添加：
ServerName my-project-name.test DocumentRoot "/var/www/my-project-name/public" AllowOverride All Require all granted ErrorLog ${APACHE_LOG_DIR}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined
重启Apache服务：
sudo systemctl restart apache2
对于本地开发，最简单的方式是直接在项目根目录运行Laravel自带的开发服务器：
php artisan serve
这会在
http://127.0.0.1:8000
启动一个轻量级服务器，非常适合快速测试和迭代。
数据库与环境变量：
.env
.env
文件的艺术
.env
文件简直是Laravel的魔法盒，我总会提醒自己，千万不要把它提交到版本控制里（Git会自动忽略它，但意识上要记住）。它存储着应用在不同环境下的敏感配置信息，比如数据库凭据、API密钥、调试模式开关等。这使得同一个代码库可以在开发、测试和生产环境中使用不同的配置，而无需修改代码本身。
一个典型的
.env
文件可能包含以下内容：
APP_NAME="My Laravel App"APP_ENV=local # 或 production, testingAPP_KEY=base64:someRandomStringGeneratedByLaravelAPP_DEBUG=true # 开发环境设为true，生产环境设为falseDB_CONNECTION=mysqlDB_HOST=127.0.0.1DB_PORT=3306DB_DATABASE=my_laravel_dbDB_USERNAME=rootDB_PASSWORD=BROADCAST_DRIVER=logCACHE_DRIVER=fileFILESYSTEM_DISK=localQUEUE_CONNECTION=syncSESSION_DRIVER=fileSESSION_LIFETIME=120MAIL_MAILER=logMAIL_HOST=mailpitMAIL_PORT=1025MAIL_USERNAME=nullMAIL_PASSWORD=nullMAIL_ENCRYPTION=nullMAIL_FROM_ADDRESS="hello@example.com"MAIL_FROM_NAME="${APP_NAME}"AWS_ACCESS_KEY_ID=AWS_SECRET_ACCESS_KEY=AWS_DEFAULT_REGION=us-east-1AWS_BUCKET=AWS_USE_PATH_STYLE_ENDPOINT=falsePUSHER_APP_ID=PUSHER_APP_KEY=PUSHER_APP_SECRET=PUSHER_HOST=PUSHER_PORT=443PUSHER_SCHEME=httpsPUSHER_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/cachesudo 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/
3.
.env
文件不生效：有时修改了
.env
文件，但应用行为没有改变。这通常是因为配置被缓存了。
php artisan config:clearphp artisan cache:clearphp 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
。
以上就是如何在PHP环境中使用Laravel？Laravel开发环境的搭建与配置的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1293151.html
微信扫一扫 
支付宝扫一扫 
