Skip to content

安装

安装

服务器要求

Laravel 框架有一些系统要求。所有这些要求都可以通过 Laravel Homestead 虚拟机来满足,因此强烈推荐您使用 Homestead 作为本地 Laravel 开发环境。

然而,如果您不使用 Homestead,您需要确保您的服务器满足以下要求:

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

安装 Laravel

Laravel 使用 Composer 来管理其依赖项。因此,在使用 Laravel 之前,请确保您的计算机上已安装 Composer。

通过 Laravel 安装器

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

php
composer global require laravel/installer

确保将 Composer 的系统范围内的 vendor bin 目录放入您的 $PATH 中,以便系统可以找到 laravel 可执行文件。此目录在不同操作系统中的位置不同;然而,一些常见的位置包括:

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

您还可以通过运行 composer global about 并查看第一行来找到 Composer 的全局安装路径。

安装完成后,laravel new 命令将在您指定的目录中创建一个新的 Laravel 安装。例如,laravel new blog 将创建一个名为 blog 的目录,其中包含一个新的 Laravel 安装及其所有依赖项:

php
laravel new blog

通过 Composer Create-Project

或者,您也可以通过在终端中发出 Composer create-project 命令来安装 Laravel:

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

本地开发服务器

如果您在本地安装了 PHP,并希望使用 PHP 的内置开发服务器来服务您的应用程序,您可以使用 serve Artisan 命令。此命令将在 http://localhost:8000 启动一个开发服务器:

php
php artisan serve

通过 HomesteadValet 可以获得更强大的本地开发选项。

配置

公共目录

安装 Laravel 后,您应该将 Web 服务器的文档 / Web 根目录配置为 public 目录。此目录中的 index.php 作为进入您应用程序的所有 HTTP 请求的前端控制器。

配置文件

Laravel 框架的所有配置文件都存储在 config 目录中。每个选项都有文档,因此请随意查看这些文件并熟悉可用的选项。

目录权限

安装 Laravel 后,您可能需要配置一些权限。storagebootstrap/cache 目录中的目录应可由您的 Web 服务器写入,否则 Laravel 将无法运行。如果您使用 Homestead 虚拟机,这些权限应该已经设置好了。

应用程序密钥

安装 Laravel 后,您应该将应用程序密钥设置为一个随机字符串。如果您通过 Composer 或 Laravel 安装器安装了 Laravel,此密钥已通过 php artisan key:generate 命令为您设置。

通常,此字符串应为 32 个字符长。密钥可以在 .env 环境文件中设置。如果您尚未将 .env.example 文件复制到一个名为 .env 的新文件中,您现在应该这样做。如果未设置应用程序密钥,您的用户会话和其他加密数据将不安全!

其他配置

Laravel 开箱即用几乎不需要其他配置。您可以自由地开始开发!然而,您可能希望查看 config/app.php 文件及其文档。它包含几个选项,如 timezonelocale,您可能希望根据您的应用程序进行更改。

您可能还希望配置 Laravel 的一些其他组件,例如:

Web 服务器配置

目录配置

Laravel 应始终从为您的 Web 服务器配置的“Web 目录”的根目录提供服务。您不应尝试从“Web 目录”的子目录中提供 Laravel 应用程序。尝试这样做可能会暴露您应用程序中的敏感文件。

美化 URL

Apache

Laravel 包含一个 public/.htaccess 文件,用于提供不带 index.php 前端控制器的 URL。在使用 Apache 提供 Laravel 之前,请确保启用 mod_rewrite 模块,以便服务器能够识别 .htaccess 文件。

如果 Laravel 附带的 .htaccess 文件不适用于您的 Apache 安装,请尝试以下替代方案:

php
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 前端控制器:

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

使用 HomesteadValet 时,美化 URL 将自动配置。