安装
Laravel 应用程序是使用 Composer (一种流行的 PHP 依赖管理器) 安装和管理的。有两种方法可以创建新的 Laravel 应用程序。
通过作曲家
$ composer create-project laravel/laravel [foldername]
要么
$ composer create-project --prefer-dist laravel/laravel [foldername]
将 [foldername] 替换为你希望安装新 Laravel 应用程序的目录的名称。安装前一定不能存在。你可能还需要将 Composer 可执行文件添加到系统路径中。
如果要使用特定版本的框架创建 Laravel 项目,可以提供版本模式,否则你的项目将使用最新的可用版本。
例如,如果你想在 Laravel 5.2 中创建项目,那么你将运行:
$ composer create-project --prefer-dist laravel/laravel 5.2.*
为什么 –prefer-dist
下载包有两种方法:source
和 dist
。对于稳定版本,Composer 默认使用 dist
。source
是版本控制存储库。如果启用了 --prefer-source
,则 Composer 将从源安装(如果有)。
--prefer-dist
与 --prefer-source
相反,如果可能的话告诉 Composer 从 dist
安装。这可以大大加快构建服务器上的安装速度,以及通常不运行供应商更新的其他用例。如果你没有正确的设置,它还可以避免 Git 问题。
通过 Laravel 安装程序
Laravel 提供了一个有用的命令行实用程序来快速创建 Laravel 应用程序。首先,安装安装程序:
$ composer global require laravel/installer
你必须确保 Composer 二进制文件夹位于$ PATH 变量中以执行 Laravel 安装程序。
首先,查看它是否已经在你的$ PATH 变量中
echo $PATH
如果一切正确,输出应包含以下内容:
Users/yourusername/.composer/vendor/bin
如果没有,请编辑你的
.bashrc
,或者,如果你使用 ZSH,则编辑你的.zshrc
,使其包含 Composer 供应商目录的路径。
安装后,此命令将在你指定的目录中创建一个全新的 Laravel 安装。
laravel new [foldername]
你也可以使用 .
(一个点)代替 [foldername] 在当前工作目录中创建项目而不创建子目录。
运行应用程序
Laravel 绑定了一个基于 PHP 的 Web 服务器,可以通过运行来启动
$ php artisan serve
默认情况下,HTTP 服务器将使用端口 8000,但如果端口已在使用中,或者如果要一次运行多个 Laravel 应用程序,则可以使用 --port
标志指定其他端口:
$ php artisan serve --port=8080
HTTP 服务器将使用 localhost
作为运行应用程序的默认域,但你可以使用 --host
标志指定不同的地址:
$ php artisan serve --host=192.168.0.100 --port=8080
使用其他服务器
如果你更喜欢使用其他 Web 服务器软件,则会在项目的 public
目录中为你提供一些配置文件; 用于 Apache 的 .htaccess
和用于 ASP.NET 的 web.config
。对于 NGINX 等其他软件,你可以使用各种在线工具转换 Apache 配置。
该框架需要 Web 服务器用户对以下目录具有写权限:
/storage
/bootstrap/cache
在* nix 操作系统上,这可以通过以下方式实现
chown -R www-data:www-data storage bootstrap/cache
chmod -R ug+rwx storage bootstrap/cache
(其中 www-data
是 Web 服务器用户的名称和组)
你选择的 Web 服务器应配置为从项目的/public
目录提供内容,这通常通过将其设置为文档根目录来完成。不应通过 Web 服务器访问项目的其余部分。
如果你正确设置了所有内容,导航到你网站的网址应显示 Laravel 的默认目标网页。