T-DOC
  • Laravel-11
  • Laravel-10
  • Laravel-6X
  • Laravel-5.5
Dcat-Admin
  • Yii2
  • 重构2
  • Laravel-11
  • Laravel-10
  • Laravel-6X
  • Laravel-5.5
Dcat-Admin
  • Yii2
  • 重构2
  • 前言

    • 发行说明
    • 升级说明
    • 贡献导引
  • 入门指南

    • 安装
    • 配置信息
    • 文件夹结构
    • Homestead
    • Valet
    • 部署
  • 核心架构

    • 请求周期
    • 服务容器
    • 服务提供者
    • Facades
    • 契约
  • 基础功能

    • 路由
    • 中间件
    • CSRF 保护
    • 控制器
    • 请求
    • 响应
    • 视图
    • 生成 URL
    • Session
    • 表单验证
    • 错误
    • 日志
  • 前端开发

    • Blade 模板
    • 本地化
    • 前端指南
    • 编辑资源 Mix
  • 安全相关

    • 用户认证
    • API 认证
    • 用户授权
    • Email 认证
    • 加密解密
    • 哈希
    • 重置密码
  • 综合话题

    • Artisan 命令行
    • 广播系统
    • 缓存系统
    • 集合
    • 事件系统
    • 文件存储
    • 辅助函数
    • 邮件发送
    • 消息通知
    • 扩展包开发
    • 队列
    • 任务调度
  • 数据库

    • 快速入门
    • 查询构造器
    • 分页
    • 数据库迁移
    • 数据填充
    • Redis
  • Eloquent ORM

    • 快速入门
    • 模型关联
    • Eloquent 集合
    • 修改器
    • API 资源
    • 序列化
  • 测试相关

    • 快速入门
    • HTTP 测试
    • 命令行测试
    • 数据库测试
    • 测试模拟器 Mocking
  • 官方扩展包

    • Cashier 交易工具包
    • Dusk 浏览器测试
    • Envoy 部署工具
    • Horizon 队列管理工具
    • Passport OAuth 认证
    • Scout 全文搜索
    • Socialite 社会化登录
    • Telescope 调试工具

本文档最新版为 10.x,旧版本可能放弃维护,推荐阅读最新版!

安装

  • 安装
    • 服务器要求
    • 安装 Laravel
    • 配置
  • Web 服务器配置
    • 优雅链接

安装

服务器要求

Laravel 对系统有一些要求。当然,所有这些要求 Laravel Homestead 虚拟机都能满足,因此强烈推荐你使用 Homestead 做为你的开发环境。

当然,假如你不使用 Homestead,请确保你的服务器满足以下要求:

  • PHP >= 7.2.5
  • BCMath PHP 拓展
  • Ctype PHP 拓展
  • JSON PHP 拓展
  • Mbstring PHP 拓展
  • OpenSSL PHP 拓展
  • PDO PHP 拓展
  • Tokenizer PHP 拓展
  • XML PHP 拓展

安装 Laravel

Laravel 使用 Composer 来管理项目依赖。因此,在使用 Laravel 之前,请确保你的机器已经安装了 Composer。

通过 Laravel 安装器

首先,通过使用 Composer 安装 Laravel 安装器:

composer global require laravel/installer

确保将 Composer’s system-wide vendor 目录放置在你的系统环境变量 $PATH 中,以便系统可以找到 Laravel 的可执行文件。该目录根据你的操作系统存在不同的位置中;一些常见的配置包括 :

  • macOS and GNU / Linux 发行版: $HOME/.config/composer/vendor/bin
  • Windows: %USERPROFILE%\AppData\Roaming\Composer\vendor\bin

安装完成后, laravel new 命令会在你指定的目录创建一个全新的 Laravel 项目。例如, laravel new blog 将会创建一个名为 blog 的目录,并已安装好 Laravel 所有的依赖项:

laravel new blog

通过 Composer 创建项目

或者,你也可以在终端中运行 create-project 命令来安装 Laravel:

composer create-project --prefer-dist laravel/laravel blog "6.*"

本地开发环境

如果你在本地安装了 PHP, 并且你想使用 PHP 内置的服务器来为你的应用程序提供服务,则可以使用 Artisan 命令 serve 。该命令会在 http://localhost:8000上启动开发服务器:

php artisan serve

当然,最好还是选择 Homestead 和 Valet。

配置

公共路径

安装完 Laravel 之后,你应该配置你的 web 服务的文档目录指向 public 路径。该路径下的 index.php 文件作为进入应用的所有 HTTP 请求的前端控制器。

配置文件

Laravel 框架的所有配置文件存放在 config 目录下。每个选项都有文档标注,便于通过文件查看并熟悉对你有用的选项。

目录权限

在安装 Laravel 后,你可能需要配置一些权限。 storage 和 bootstrap/cache 目录在你的 web 服务下应该是可写的权限,否则 Laravel 将无法运行。如果你用的是 Homestead 虚拟机,这些权限应该已经设置好了。

应用密钥

安装好 Laravel 之后的下一步是设置你的应用密钥为随机字符串。如果你通过 Composer 或者 Laravel 安装器安装的,这个密钥已经通过 php artisan key:generate 命令为你设置好了。

通常,这个字符串应该是 32 个字符长度。这个密钥将会设置在环境变量文件 .env 中。如果你还没有将 .env.example 文件重命名为 .env 那么你现在应当把此文件重命名。 如果应用密钥还没有设置,你的用户会话和其他的加密数据将会不安全

其他配置

Laravel 几乎不需要除上面所说的其他什么配置了。你可以随心所欲的开始开发了!然而,你可能会想要再次查看 config/app.php 文件和它的注释说明。它包含一些你希望根据你应用来更改的选项,诸如: timezone 和 locale 。

你还可能想要配置 Laravel 的其他的一些组件,例如:

  • 缓存
  • 数据库
  • 会话控制

Web 服务器配置

优雅链接

Apache

Laravel 中包含了一个 public/.htaccess 文件,通常用于在资源路径中隐藏 index.php 的前端控制器。在用 Apache 为 Laravel 提供服务之前,确保启用了 mod_rewrite 模块,这样 .htaccess 文件才能被服务器解析。

如果 Laravel 附带的 .htaccess 文件不起作用,尝试下面的方法替代:

Options +FollowSymLinks -Indexes
RewriteEngine On

RewriteCond %{HTTP:Authorization} .
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

Nginx

如果你使用 Nginx ,在你的站点配置中加入以下配置,所有的请求将会引导至 index.php 前端控制器:

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

当你使用 Homestead 或 Valet 时,优雅链接将会自动配置好。

本译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。


原文地址:https://learnku.com/docs/laravel/6.x/ins...

译文地址:https://learnku.com/docs/laravel/6.x/ins...

Last Updated:
Contributors: Hans
Next
配置信息