在 LNMP 上建立 Laravel 專案

安裝 composer

1. 下載 composer-setup.php 安裝程式

   • 請確認你已經先安裝好 PHP 才能執行以下指令

   $ php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
   

2. 檢查已下載的檔案

   • 確保檔案沒被竄改，顯示「Installer verified」表示沒問題
   • 如果不行的話，可能是更新了，直接到 composer 官網 找新的檔案

   $ php -r "if (hash_file('sha384', 'composer-setup.php') === 'a5c698ffe4b8e849a443b120cd5ba38043260d5c4023dbf93e1558871f1f07f58274fc6f4c93bcfd858c6bd0775cd8d1') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
   

3. 執行安裝

   $ php composer-setup.php
   

4. 刪除安裝檔

   $ php -r "unlink('composer-setup.php');"
   

5. 設置全域指令

   • 這個 composer.phar 工具目前只能在所屬的目錄下才能執行，這樣使用上有點麻煩，可以把它移動到我們自己的指令目錄，當成全域指令。同時改名為 composer 方便輸入：
   • 註：前提是 /usr/local/bin 已經加入 $PATH 中 PATH=/usr/local/bin:$PATH

   $ mv composer.phar /usr/local/bin/composer
   

6. 查看版本即安裝完成

   $ composer -v
   

   

安裝 Laravel 專案

• 建立一個名為 blog 的專案

  $ composer create-project --prefer-dist laravel/laravel blog
  

新增一個資料庫

• 輸入資料庫名稱之後點擊 create

設定專案連結資料庫的資訊

• 修改專案的 .env

  DB_HOST=127.0.0.1
  DB_PORT=3306
  DB_DATABASE=blog
  DB_USERNAME=root
  DB_PASSWORD=password
  

開啟權限

• 開啟 bootstrap cache 目錄權限

  $ chmod -R 777 bootstrap/cache/
  

• 開啟 storage 目錄權限

  $ chmod -R 777 storage/
  

設定 Nginx

1. 新增並編輯 /etc/nginx/conf.d/blog.conf

   $ sudo vi /etc/nginx/conf.d/blog.conf
   

2. /etc/nginx/conf.d/blog.conf 內容可參考 Laravel 官網的配置

   • server_name 為你的域名
   • root 為目標資料夾
   • fastcgi_pass 要和你的 php-fpm 設定一樣

   server {
      listen 80;
      server_name vm-blog.com;
      root /usr/share/nginx/html/blog/public;
   
      add_header X-Frame-Options "SAMEORIGIN";
      add_header X-XSS-Protection "1; mode=block";
      add_header X-Content-Type-Options "nosniff";
   
      index index.html index.htm index.php;
   
      charset utf-8;
   
      location / {
          try_files $uri $uri/ /index.php?$query_string;
      }
   
      location = /favicon.ico { access_log off; log_not_found off; }
      location = /robots.txt  { access_log off; log_not_found off; }
   
      error_page 404 /index.php;
   
      location ~ \.php$ {
          fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;
          fastcgi_index index.php;
          fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
          include fastcgi_params;
      }
   
      location ~ /\.(?!well-known).* {
          deny all;
      }
   }
   

3. 檢查 Nginx 設定是否正確

   $ sudo nginx -t
   

4. 重新載入 Nginx 的設定

   $ sudo nginx -s reload
   

完成

• 瀏覽器輸入 vm-blog.com，可以成功看到 Laravel 預設畫面

參考資料

• 使用 Composer 管理 PHP 套件