安装

未匹配的标注
本文档最新版为 10.x,旧版本可能放弃维护,推荐阅读最新版!

Laravel 安装指南#

安装#

{video} 你是一个喜欢看视频的学习者么? Laracasts 为刚刚使用这个框架的新手们提供了一个 免费、深入的 Laravel 视频 。这是一个开始你学习之途的好地方。

服务器要求#

Laravel 框架会有一些系统上的要求。当然,这些要求在 Laravel Homestead 虚拟机上都已经完全配置好了。所以,非常推荐你使用 Homestead 作为你的本地 Laravel 开发环境。

然而,如果你没有使用 Homestead ,你需要确保你的服务器上安装了下面的几个拓展:

  • PHP >= 5.6.4
  • OpenSSL PHP Extension
  • PDO PHP Extension
  • Mbstring PHP Extension
  • Tokenizer PHP Extension
  • XML PHP Extension

译者注:强烈推荐使用 Homestead 作为开发环境,尤其是新手,可以避免很多不必要的麻烦。线上环境可以参考 Homestead 的环境部署脚本 进行部署。

安装 Laravel#

Laravel 使用 Composer 来管理代码依赖。所以,在使用 Laravel 之前,请先确认你的电脑上安装了 Composer。

通过 Laravel 安装工具#

首先,使用 Composer 下载 Laravel 安装包:

composer global require "laravel/installer"

请确定你已将 ~/.composer/vendor/bin 路径加到 PATH,只有这样系统才能找到 laravel 的执行文件。

一旦安装完成,就可以使用 laravel new 命令在指定目录创建一个新的 Laravel 项目,例如:laravel new blog 将会在当前目录下创建一个叫 blog 的目录,此目录里面存放着新安装的 Laravel 和代码依赖。这个方法的安装速度比通过 Composer 安装要快上许多:

laravel new blog

因为代码依赖是直接一起打包安装的。

通过 Composer Create-Project#

除此之外,你也可以通过 Composer 在命令行运行 create-project 命令来安装 Laravel:

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

本地开发服务器#

如果你在本地安装了 PHP,你可能希望像运行 PHP 内置的开发服务器一样来访问自己的应用程序,你可以使用 serve Artisan 命令来启动一个本地开发服务器,这样你就可以在 http://localhost:8000 来访问它。

php artisan serve

不过有更健壮的本地开发选项可用,比如 HomesteadValet

配置#

入口目录#

在安装 Laravel 之后,你需要配置你的 Web 服务器的根目录为 public 目录。 这个目录的 index.php 文件作为所有 HTTP 请求进入应用的前端处理器。

配置文件#

Laravel 框架所有的配置文件都存放在 config 目录下。每个选项都被加入文档,所以你可以自由的浏览文件,轻松的熟悉你的选项。

目录权限#

安装 Laravel 之后, 你需要配置一些权限 。 storagebootstrap/cache 目录应该允许你的 Web 服务器写入,否则 Laravel 将无法写入。如果你使用 Homestead 虚拟机,这些权限应该已经被设置好了。

应用程序密钥#

在你安装完 Laravel 后,首先需要做的事情是设置一个随机字符串的密钥。假设你是通过 Composer 或是 Laravel 安装工具安装的 Laravel,那么这个密钥已经通过 key:generate 命令帮你设置完成。

通常这个密钥会有 32 字符长。这个密钥可以被设置在 .env 环境文件中。如果你还没将 .env.example 文件重命名为 .env,那么你现在应该去设置下。如果你没有设置应用程序密钥,你的用户 Session 和 其他加密数据将不安全!

额外配置#

Laravel 几乎不需做任何其它设置就可以马上使用,但是建议你先浏览 config/app.php 文件和对应的文档,这里面包含着一些选项,如 时区语言环境,你可以根据应用程序的情况来修改。

你也可以设置 Laravel 的几个附加组件,像是:

一旦 Laravel 安装完成,你应该立即 设置本机环境

Web 服务器配置#

优雅链接#

Apache#

Laravel 框架通过 public/.htaccess 文件来让 URL 不需要 index.php 即可访问。在 Apache 启用 Laravel 之前,请确认是否有开启 mod_rewrite 模块,以便 .htaccess 文件发挥作用。

如果 Laravel 附带的 .htaccess 文件在 Apache 中无法使用的话,请尝试下方的做法:

Options +FollowSymLinks
RewriteEngine On

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 的话, 它会自动的帮你设置好优雅链接。


{note} 欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。

转载请注明:本文档由 Laravel China 社区 [laravel-china.org] 组织翻译,详见 翻译召集帖

文档永久地址: d.laravel-china.org

本文章首发在 LearnKu.com 网站上。

上一篇 下一篇
《L05 电商实战》
从零开发一个电商项目,功能包括电商后台、商品 & SKU 管理、购物车、订单管理、支付宝支付、微信支付、订单退款流程、优惠券等
《L02 从零构建论坛系统》
以构建论坛项目 LaraBBS 为线索,展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。
贡献者:1
讨论数量: 14
发起讨论 只看当前版本


light-and-dark
excel 导出
1 个点赞 | 5 个回复 | 代码速记 | 课程版本 8.5
admin7742
CURLPOST
0 个点赞 | 5 个回复 | 代码速记 | 课程版本 8.x
SnowZh
使用 Laravel sail 如何安装指定版本?
0 个点赞 | 2 个回复 | 问答 | 课程版本 8.5
abc123123123456
敏感词过滤
0 个点赞 | 1 个回复 | 分享 | 课程版本 8.5
abc123123123456
七牛云扩展
0 个点赞 | 0 个回复 | 分享 | 课程版本 8.5
kang_lin
比较明亮的显示
0 个点赞 | 0 个回复 | 代码速记 | 课程版本 8.5
jianghushusheng
图片分割
0 个点赞 | 0 个回复 | 代码速记 | 课程版本 8.x
esssd
date 高亮显示
0 个点赞 | 0 个回复 | 代码速记 | 课程版本 8.x
jianghushusheng
gcms
0 个点赞 | 0 个回复 | 代码速记 | 课程版本 8.x
hei123
php artisan make:command withdraw
0 个点赞 | 0 个回复 | 代码速记 | 课程版本 8.x
Queen_Lr
发送验证码
0 个点赞 | 0 个回复 | 分享 | 课程版本 8.x
XiaoSir
图片防盗链
0 个点赞 | 0 个回复 | 代码速记 | 课程版本 8.x
anningri
laravel new 不出东西来
0 个点赞 | 0 个回复 | 问答 | 课程版本 5.8
jiayier
如何让 API 的返回数据格式统一(Laravel5.8)
0 个点赞 | 0 个回复 | 问答 | 课程版本 5.8