Laravel框架怎么安装_Laravel框架安装步骤详细图文教程

首先确认环境满足PHP>=8.1、已安装Composer,然后通过laravel new或composer create-project创建项目,最后用php artisan serve启动服务即可访问Laravel欢迎页面。

Laravel 是目前最流行的 PHP 框架之一,以优雅的语法和强大的功能著称。安装 Laravel 并不复杂,只要你的开发环境准备就绪,几分钟内就能完成。下面是一份详细的 Laravel 安装步骤图文教程,适合新手快速上手。

准备工作:检查系统环境

在安装 Laravel 之前,确保你的电脑满足以下基本条件:

  • PHP >= 8.1(建议使用最新稳定版)
  • Composer 工具已安装(PHP 的依赖管理工具)
  • 支持的数据库(如 MySQL、SQLite 等)
  • Web 服务器(如 Apache 或 Nginx,或直接使用 PHP 内置服务器)

打开终端或命令提示符,输入以下命令检查 PHP 和 Composer 是否可用:

php -v
composer -v

如果看到版本信息,说明环境已配置好。

安装 Laravel 安装器(可选)

Laravel 提供了一个官方的全局安装器,可以更方便地创建新项目。

运行以下命令安装 Laravel 安装器:

composer global require laravel/installer

安装完成后,就可以用 laravel new 命令创建项目。

方法一:使用 Laravel 安装器创建项目

执行以下命令创建一个名为 myproject 的 Laravel 应用:

laravel new myproject

等待几分钟,Composer 会自动下载并配置所有依赖。完成后你会看到类似“Application ready!”的提示。

方法二:通过 Composer 创建项目(推荐)

如果你没有安装 Laravel 全局工具,可以直接用 Composer 创建项目:

composer create-project --prefer-dist laravel/laravel myproject

这条命令会从 Packagist 下载最新稳定版 Laravel,并安装到 myproject 文件夹中。

启动开发服务器

进入项目目录:

cd myproject

启动内置的 PHP 开发服务器:

php artisan serve

看到如下输出表示启动成功:

Laravel development server started:

打开浏览器,访问 https://www./link/f0838b2ebfc6440a474eabdc326bf31a,你将看到 Laravel 的欢迎页面。

常见问题与解决

安装过程中可能会遇到一些问题,这里列出几个常见的:

  • 报错:file_put_contents(): Permission denied —— 检查 storage 和 bootstrap/cache 目录权限,确保 Web 服务器有写入权限。
  • Class 'Illuminate\Support\Facades\...' not found —— 运行 composer dump-autoload 重建自动加载文件。
  • Mcrypt PHP extension required —— Laravel 9+ 不再需要 mcrypt,建议升级 PHP 版本并确认扩展正确安装。

配置 .env 文件(重要)

项目根目录下的 .env 文件是环境配置文件,用于设置数据库、缓存、邮件等参数。

例如,修改数据库连接:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_db_user
DB_PASSWORD=your_db_password

修改后无需重启服务,Laravel 会自动读取配置。

基本上就这些。按照以上步骤操作,你应该已经成功安装并运行了 Laravel 项目。后续可以学习路由、控制器、Eloquent 模型等核心功能,逐步构建自己的应用。