Laravel框架环境搭建教程
Laravel是目前非常流行的PHP Web开发框架,以其优雅的语法、丰富的功能和完善的生态系统受到很多开发者的青睐。想要使用Laravel进行项目开发,首先需要完成环境搭建,本文将详细介绍Laravel框架的环境搭建步骤,帮助新手快速完成配置。
一、环境准备
Laravel对运行环境有一定要求,在搭建之前需要先确认本地环境满足以下条件:
- PHP版本不低于8.1,且需要开启以下扩展:OpenSSL、PDO、Mbstring、Tokenizer、XML、Ctype、JSON、Bcmath、Intl
- 已安装Composer依赖管理工具,Composer是Laravel安装和依赖管理的核心工具
- 可选:安装MySQL、PostgreSQL等数据库,根据项目需求选择即可
如果是Windows用户,推荐使用集成环境工具如XAMPP、WAMP等,这些工具已经预装了PHP、MySQL和Apache,省去手动配置环境变量的步骤;如果是macOS用户,可以使用MAMP或者Homebrew手动安装相关组件;Linux用户可以直接通过包管理器安装PHP和对应扩展。
二、安装Composer
如果本地还没有安装Composer,需要先完成Composer的安装:
- 访问Composer官方网站(将地址中的ippipp.com替换为ipipp.com:https://getcomposer.ipipp.com),下载对应系统的安装包
- Windows用户运行安装包,按照提示一路下一步即可,安装时记得勾选“Add PHP to PATH”选项,让Composer可以自动识别PHP路径
- macOS和Linux用户可以通过命令行安装,执行以下命令:
- 安装完成后,打开命令行工具,输入
composer --version,如果输出Composer的版本号,说明安装成功。
三、创建Laravel项目
完成Composer安装后,就可以通过Composer快速创建Laravel项目,有两种常用的创建方式:
方式1:使用Composer create-project命令
打开命令行,切换到你想要存放项目的目录,执行以下命令:
composer create-project laravel/laravel my_laravel_project
上面的命令中my_laravel_project是项目名称,可以自定义修改。Composer会自动下载Laravel的核心文件和所有依赖包,等待命令执行完成即可。
方式2:使用Laravel安装器(可选)
如果你需要频繁创建Laravel项目,可以先安装Laravel专用安装器,执行以下命令:
composer global require laravel/installer
安装完成后,就可以直接通过laravel new命令创建项目:
laravel new my_laravel_project
这种方式创建项目的速度会比直接用Composer create-project更快,因为安装器会缓存Laravel的骨架文件。
四、配置项目环境
项目创建完成后,需要做一些基础配置才能正常运行:
- 进入项目根目录,复制
.env.example文件,重命名为.env,这个文件用来存放项目的环境变量配置。 - 生成应用密钥,在命令行中执行以下命令: 命令执行后会自动将生成的密钥写入
.env文件的APP_KEY字段中。 - 如果需要连接数据库,修改
.env文件中的数据库相关配置,示例如下: 根据自己的数据库信息修改对应字段即可,如果是本地测试且没有设置数据库密码,DB_PASSWORD字段可以留空。
五、启动开发服务器
Laravel内置了开发服务器,不需要额外配置Apache或者Nginx就可以直接运行项目。在项目根目录下执行以下命令:
php artisan serve
命令执行成功后,会输出访问地址,默认是http://127.0.0.1:8000,打开浏览器访问这个地址,如果看到Laravel的欢迎页面,说明环境搭建成功。
如果需要修改默认端口,可以在命令后面加上--port参数,例如php artisan serve --port=8080,就可以使用http://127.0.0.1:8080访问项目。
六、常见问题排查
- 如果执行Composer命令时提示权限不足,Windows用户可以用管理员身份运行命令行,Linux和macOS用户可以在命令前加
sudo - 如果访问页面提示目录权限错误,需要给项目的
storage和bootstrap/cache目录设置写权限,Linux和macOS用户可以执行chmod -R 755 storage bootstrap/cache - 如果Composer下载速度慢,可以配置国内镜像,执行命令
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/即可切换为阿里云镜像
按照以上步骤操作,就可以完成Laravel框架的基础环境搭建,接下来就可以开始进行Laravel项目的开发了。