在使用 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/)中的相關章節。