在使用 laravel 进行开发时,有时我们需要在当前所在目录下创建一个新的 laravel 项目,而不是在 laravel 安装器提供的默认目录下(例如 /var/www/html/ 或 ~/sites/)。本文将介绍如何在当前目录下安装 laravel。
1. 准备工作
在开始之前,请确保系统已经满足了 Laravel 的运行要求,例如 php,apache 或 nginx 等依赖软件已经安装并配置好。可以通过 PHP 官方网站(https://www.php.net/)获取 PHP 的安装包,并通过官方文档了解如何安装和配置。
2. 下载 Laravel 安装包
为了在当前目录下安装 Laravel,我们需要下载 Laravel 的安装包。有两种方法可以下载 Laravel 安装包:
2.1 使用 composer
Laravel 的首选安装方式是使用 Composer 进行安装。在终端中打开当前目录,执行以下命令:
composer create-project --prefer-dist laravel/laravel .
注意,命令中的 . 表示当前目录。–prefer-dist 参数意味着优先使用已经打包好的文件,而不是从 gitHub 上拉取源码。
执行完成后,Laravel 的核心文件已经被安装并保存在当前目录下。此时可以在终端中输入以下命令验证安装:
php artisan --version
如果输出了 Laravel 的版本号,则说明安装成功。
2.2 手动下载
除了使用 Composer 安装以外,我们也可以直接手动下载 Laravel 安装包。
访问 Laravel 的官方网站(https://laravel.com/),点击页面中的“Download”按钮,选择最新的稳定版本,下载 .zip 或 .tar.gz 压缩包。
下载完成后,将压缩包解压到当前目录下,并将解压后的文件夹重命名为项目名称(例如 my-laravel-project)。此时也可以通过终端中的 php artisan –version 命令验证安装是否成功。
3. 配置虚拟主机
为了让 Apache 或 Nginx 能够正确访问 Laravel 项目,我们需要在本地创建一个虚拟主机并配置域名解析。以下是配置 Apache 虚拟主机的示例:
3.1 Apache 配置示例
打开 Apache 的虚拟主机配置文件,例如在 ubuntu 中可以执行以下命令:
sudo nano /etc/apache2/sites-available/my-laravel-project.conf
在文件中添加以下内容:
<virtualhost> ServerName my-laravel-project.test DocumentRoot /path/to/my-laravel-project/public <directory> AllowOverride All Require all granted </directory></virtualhost>
其中,my-laravel-project.test 是虚拟主机所对应的域名,需要在 /etc/hosts 中添加一条记录:
127.0.0.1 my-laravel-project.test
/path/to/my-laravel-project 需要替换为 Laravel 项目所在的目录路径。保存并关闭文件后,执行以下命令来启用虚拟主机:
sudo a2ensite my-laravel-project.conf sudo service apache2 restart
此时在浏览器中访问 http://my-laravel-project.test,应该可以看到 Laravel 的欢迎页面。
3.2 Nginx 配置示例
Nginx 的虚拟主机配置和 Apache 略有不同,以下是一个示例:
server { listen 80; server_name my-laravel-project.test; root /path/to/my-laravel-project/public; index index.php; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ .php$ { include fastcgi_params; fastcgi_pass unix:/run/php/php7.2-fpm.sock; fastcgi_param SCRIPT_FILENAME $request_filename; fastcgi_param PHP_VALUE "date.timezone=Asia/Shanghai"; } }
其中 /path/to/my-laravel-project 需要替换为 Laravel 项目所在的目录路径。保存并关闭文件后,执行以下命令来启用虚拟主机:
sudo ln -s /etc/nginx/sites-available/my-laravel-project /etc/nginx/sites-enabled/my-laravel-project sudo service nginx restart
此时在浏览器中访问 http://my-laravel-project.test,也应该可以看到 Laravel 的欢迎页面。
4. 配置环境文件
Laravel 项目需要一些环境变量和配置文件来正确运行。在当前目录下,我们可以创建一个 .env 文件,用于存放这些配置。可以通过拷贝默认的 .env.example 文件并重命名来创建:
cp .env.example .env
然后编辑 .env 文件,将其中的 APP_KEY、DB_ 等关键配置项修改为自己的值。
5. 完成
至此,Laravel 项目已经在当前目录下安装并配置好,可以开始进行开发。建议在终端中执行以下命令初始化 Git 仓库:
git init git add . git commit -m "initial commit"
这样可以保证代码的安全性和版本控制能力。有关 Laravel 的详细使用方法,可以参考官方文档(https://laravel.com/docs/)中的相关章节。