安装

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

安装

安装

{video} 你是一位初学者吗? Laracasts 为您提供免费而又全面的 Laravel 教程。它是你开始 Laravel 学习之旅的好地方。

服务器要求

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

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

  • PHP >= 7.1.3
  • OpenSSL PHP
  • PHP PDO 扩展
  • PHP Mbstring 扩展
  • PHP Tokenizer 扩展
  • PHP XML 扩展
  • PHP Ctype 扩展
  • PHP JSON 扩展

安装 Laravel

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

通过 Laravel 安装器

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

composer global require "laravel/installer"

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

  • macOS: $HOME/.composer/vendor/bin
  • GNU / Linux 发行版: $HOME/.config/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

本地开发环境

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

php artisan serve

当然,最好的选择还是 HomesteadValet

配置

公共目录

安装完 Laravel 之后,你必须将 web 服务器根目录指向 public 目录。该目录下的 index.php 文件将作为所有进入应用程序的 HTTP 请求的前端控制器。

配置文件

Laravel 框架的所有配置文件都放在 config 目录中。每个选项都有注释,方便你随时查看文件并熟悉可用的选项。

目录权限

安装完 Laravel 后,你可能需要给这两个文件配置读写权限:storage 目录和 bootstrap/cache 目录应该允许 Web 服务器写入,否则 Laravel 程序将无法运行。 如果你使用的是 Homestead 虚拟机, 这些权限已经为你配置好了。

应用密钥

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

通常来说,这个字符串长度为 32 个字符。密钥可以在 .env 环境文件中设置。前提是你要将 .env.example 文件重命名为 .env如果应用程序密钥没有被设置,就不能确保你的用户会话和其他加密数据的安全!

其他配置

除了以上的配置,Laravel 几乎就不需要再配置什么了。你随时就能开发!但是,可能的话,还是希望你查看 config/app.php 文件及其注释。它包含几个你可能想要根据你的应用来更改的选项,比如 timezonelocale

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

Web 服务器配置

优雅链接

Apache

Laravel 使用 public/.htaccess 文件来为前端控制器提供了隐藏 index.php 的优雅链接. Laravel 使用 Apache 作为服务器,请务必启用 mod_rewrite 模块 让服务器能够支持 .htaccess 的解析。

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

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;
}

当然,你使用 HomesteadValet,优雅链接会自动配置。

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

本译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。
上一篇 下一篇
Summer
《L01 基础入门》
我们将带你从零开发一个项目并部署到线上,本课程教授 Web 开发中专业、实用的技能,如 Git 工作流、Laravel Mix 前端工作流等。
《L02 从零构建论坛系统》
以构建论坛项目 LaraBBS 为线索,展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。
贡献者:4
讨论数量: 6
发起讨论 只看当前版本


kiyoma
使用 Laravel new 指令创建项目如何制定版本?
0 个点赞 | 13 个回复 | 问答 | 课程版本 5.5
kennethgao
说好的夜间模式呢?
0 个点赞 | 5 个回复 | 问答 | 课程版本 5.5
piscon
硬件坑需要注意!
0 个点赞 | 1 个回复 | 分享 | 课程版本 5.7
Jea
安装完后没 env?
0 个点赞 | 1 个回复 | 问答 | 课程版本 5.6
jiayier
如何让 API 的返回数据格式统一(Laravel5.8)
0 个点赞 | 0 个回复 | 问答 | 课程版本 5.8
tsin
"Pretty URLs" 的翻译
0 个点赞 | 0 个回复 | 分享 | 课程版本 5.6