在使用Laravel 進行開發時,有時我們需要在目前所在目錄下建立一個新的Laravel 項目,而不是在Laravel 安裝器提供的預設目錄下(例如/var/www/html/
或~/Sites/
)。本文將介紹如何在目前目錄下安裝 Laravel。
在開始之前,請確保系統已經滿足了 Laravel 的運行要求,例如 PHP,Apache 或 Nginx 等依賴軟體已經安裝並配置好。可以透過 PHP 官方網站(https://www.php.net/)取得 PHP 的安裝包,並透過官方文件了解如何安裝和設定。
為了在目前目錄下安裝 Laravel,我們需要下載 Laravel 的安裝套件。有兩種方法可以下載 Laravel 安裝套件:
Laravel 的首選安裝方式是使用 Composer 進行安裝。在終端機中開啟目前目錄,執行下列指令:
composer create-project --prefer-dist laravel/laravel .
注意,指令中的 .
表示目前目錄。 --prefer-dist
參數意味著優先使用已經打包好的文件,而不是從 GitHub 上拉取原始碼。
執行完成後,Laravel 的核心檔案已經安裝並保存在目前目錄下。此時可以在終端機中輸入以下命令以驗證安裝:
php artisan --version
如果輸出了 Laravel 的版本號,則表示安裝成功。
除了使用 Composer 安裝以外,我們也可以直接手動下載 Laravel 安裝套件。
造訪Laravel 的官方網站(https://laravel.com/),點擊頁面中的「Download」按鈕,選擇最新的穩定版本,下載.zip
或 .tar.gz
壓縮包。
下載完成後,將壓縮套件解壓縮到目前目錄下,並將解壓縮後的資料夾重新命名為專案名稱(例如 my-laravel-project
)。此時也可以透過終端機中的 php artisan --version
指令驗證安裝是否成功。
為了讓 Apache 或 Nginx 能夠正確存取 Laravel 項目,我們需要在本機上建立一個虛擬主機並配置網域解析。以下是設定Apache 虛擬主機的範例:
#開啟Apache 的虛擬主機設定文件,例如在Ubuntu 中可以執行以下命令:
sudo nano /etc/apache2/sites-available/my-laravel-project.conf
在文件中加入以下內容:
<VirtualHost *:80> ServerName my-laravel-project.test DocumentRoot /path/to/my-laravel-project/public <Directory /path/to/my-laravel-project/public> 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 的歡迎頁面。
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
文件,將其中的
APP_KEY、
DB_### 等關鍵配置項修改為自己的值。 ######5. 完成######至此,Laravel 專案已經在目前目錄下安裝並設定好,可以開始進行開發。建議在終端機中執行以下命令初始化 Git 倉庫:###git init git add . git commit -m "initial commit"
以上是laravel 目前目錄安裝的詳細內容。更多資訊請關注PHP中文網其他相關文章!