chore: 升級 Laravel 5.8 → 6.0

基於 Carbon 2.x 分支完成 Laravel 6.0 升級，包含所有必要的程式碼修改和配置更新。

## 主要變更

### 依賴套件升級
- Laravel Framework: 5.8.* → ^6.0 (v6.20.45)
- Laravel Passport: 維持 ^7.0（相容 Laravel 6）
- PHP 最低版本要求: >=7.1.3 → ^7.2
- PHPUnit: ^7.5 → ^9.5（支援 PHP 8.x）
- Carbon: ^2.0（已在前序分支完成升級）

### Breaking Changes 修復

#### 1. array_except() 全域輔助函數移除（43 處修改）
Laravel 6.0 移除了 array_except() 全域函數，統一使用 Arr::except() 靜態方法。

修改的檔案：
- Controllers (9 個):
  - CodesController.php
  - BasicInformationController.php
  - BasicInformationAddressesController.php
  - BasicInformationAltnamesController.php
  - BasicInformationEntriesController.php
  - BasicInformationTextsController.php
  - BasicInformationOfficesController.php
  - BasicInformationSocialInstController.php
  - Api/BiogAddressController.php

- Repositories (4 個):
  - BiogMainRepository.php (21 處)
  - AddrBelongsDataRepository.php
  - TextInstanceDataRepository.php
  - SocialInstitutionCodeRepository.php

- Resources (1 個):
  - BiogMain.php

所有檔案均已新增 `use Illuminate\Support\Arr;` 並將 `array_except()` 替換為 `Arr::except()`。

#### 2. str_contains() 全域輔助函數移除（7 處修改）
Laravel 6.0 移除了 str_contains() 全域函數，統一使用 Str::contains() 靜態方法。

修改的檔案：
- CodesController.php (第 712-718 行)
  - 新增 `use Illuminate\Support\Str;`
  - 7 處 str_contains() 全部替換為 Str::contains()

### 套件移除與配置更新

#### naux/sendcloud 套件移除
該套件最高支援 Laravel 5.8，不相容 Laravel 6.0：
- 從 composer.json 移除依賴
- 從 config/app.php 移除 SendCloudServiceProvider 註冊
- 影響功能：使用者註冊郵件（需尋找替代方案）

### CI/CD 配置更新

#### GitHub Actions Workflow
- 移除已棄用的 `--no-suggest` 參數（Composer 2.0+ 不再支援）
- 確保 CI 流程使用 PHP 7.4 執行測試

#### .gitignore 更新
- 新增 `.phpunit.result.cache` 忽略規則
- 修正格式錯誤（分離 version.txt 和 .phpunit.result.cache）

## 相容性說明

### PHP 版本需求
- Laravel 6.0 最低要求：PHP 7.2
- Laravel 6.0 建議版本：PHP 7.2 - 7.4
- 專案目前配置：PHP 7.4（符合建議範圍）

### 已知限制
1. **SendCloud 郵件服務移除**
   - 原因：naux/sendcloud 套件不支援 Laravel 6
   - 影響：RegisterController.php 中的郵件發送功能
   - 後續：需評估替代方案（如 AWS SES、SendGrid 等）

2. **PHP 8.x 相容性警告**
   - 在 PHP 8+ 環境執行會產生棄用警告
   - 不影響實際功能運作
   - 建議在 PHP 7.4 環境部署

## 測試狀態

### 本地測試
- Composer 依賴安裝：✅ 成功
- PHPUnit 版本：9.6.29
- 測試環境：PHP 8.4（有棄用警告，預期行為）

### CI/CD 測試
- GitHub Actions 環境：PHP 7.4
- 預期結果：測試應正常通過

## 升級路徑

```
Laravel 5.6 + Carbon 1.x
  ↓ (PR cbdb-project#462)
Laravel 5.7 + Carbon 1.x
  ↓ (PR cbdb-project#467)
Laravel 5.8 + Carbon 1.x
  ↓ (PR cbdb-project#473)
Laravel 5.8 + Carbon 2.x
  ↓ (本次升級)
Laravel 6.0 + Carbon 2.x ✅
```

## 參考文件
- Laravel 6.x 升級指南：https://laravel.com/docs/6.x/upgrade
- 詳細升級說明：UPGRADE_INSTRUCTIONS.md
- Carbon 2.x 升級：已在 PR cbdb-project#473 完成

## 檢查清單

- [x] 所有 array_except() 已替換為 Arr::except()
- [x] 所有 str_contains() 已替換為 Str::contains()
- [x] composer.json 版本已更新
- [x] composer.lock 已更新
- [x] 移除不相容的套件（naux/sendcloud）
- [x] 更新服務提供者註冊
- [x] CI/CD 配置已更新
- [x] .gitignore 已更新
- [x] 基於最新 develop 分支 rebase

Author: claude

.github/workflows/phpunit.yml

@@ -29,7 +29,7 @@ jobs:
           coverage: none
 
       - name: Install dependencies
-        run: composer install --prefer-dist --no-progress --no-suggest
+        run: composer install --prefer-dist --no-progress
 
       - name: Prepare environment
         run: |

.gitignore

@@ -10,4 +10,5 @@ Homestead.yaml
 npm-debug.log
 yarn-error.log
 .env
-version.txt
+version.txt
+.phpunit.result.cache

app/Http/Controllers/Api/BiogAddressController.php

@@ -9,6 +9,7 @@
 use App\Repositories\ToolsRepository;
 use Illuminate\Http\Request;
 use App\Http\Controllers\Controller;
+use Illuminate\Support\Arr;
 use Illuminate\Support\Facades\DB;
 
 class BiogAddressController extends Controller
@@ -64,7 +65,7 @@ public function store($id, Request $request)
         }
         $data['c_addr'] = 0;
         $data = $request->all();
-        $data = array_except($data, ['_token']);
+        $data = Arr::except($data, ['_token']);
         $data['c_personid'] = $id;
         $data['c_fy_intercalary'] = (int)($data['c_fy_intercalary']);
         $data['c_ly_intercalary'] = (int)($data['c_ly_intercalary']);
@@ -123,7 +124,7 @@ public function update(Request $request, $id, $addr_id)
         $data['c_fy_intercalary'] = (int)($data['c_fy_intercalary']);
         $data['c_ly_intercalary'] = (int)($data['c_ly_intercalary']);
 
-        $data = array_except($data, ['_method', '_token']);
+        $data = Arr::except($data, ['_method', '_token']);
         $data = $this->toolsRepository->timestamp($data);
         DB::table('BIOG_ADDR_DATA')->where('tts_sysno',$addr_id)->update($data);
 //        dd(DB::table('BIOG_ADDR_DATA')->where('tts_sysno',$id)->first());

app/Http/Controllers/BasicInformationAddressesController.php

@@ -11,6 +11,7 @@
 use App\TextCode;
 use Carbon\Carbon;
 use Illuminate\Http\Request;
+use Illuminate\Support\Arr;
 use Illuminate\Support\Facades\Auth;
 use Illuminate\Support\Facades\DB;
 
@@ -74,7 +75,7 @@ public function store(Request $request, $id)
             return redirect()->back();
         }
         $data = $request->all();
-        $data = array_except($data, ['_token']);
+        $data = Arr::except($data, ['_token']);
         $data['c_personid'] = $id;
         $data['c_fy_intercalary'] = (int)($data['c_fy_intercalary']);
         $data['c_ly_intercalary'] = (int)($data['c_ly_intercalary']);
@@ -216,7 +217,7 @@ public function update(Request $request, $id, $addr)
         $data['c_fy_intercalary'] = (int)($data['c_fy_intercalary']);
         $data['c_ly_intercalary'] = (int)($data['c_ly_intercalary']);
 
-        $data = array_except($data, ['_method', '_token']);
+        $data = Arr::except($data, ['_method', '_token']);
         $data = $this->toolsRepository->timestamp($data);
         $addr = str_replace("--","-minus",$addr);
         $addr_l = explode("-", $addr);

app/Http/Controllers/BasicInformationAltnamesController.php

@@ -8,6 +8,7 @@
 use App\TextCode;
 use Carbon\Carbon;
 use Illuminate\Http\Request;
+use Illuminate\Support\Arr;
 use Illuminate\Support\Facades\Auth;
 use Illuminate\Support\Facades\DB;
 
@@ -71,7 +72,7 @@ public function store(Request $request, $id)
             return redirect()->back();
         }
         $data = $request->all();
-        $data = array_except($data, ['_token']);
+        $data = Arr::except($data, ['_token']);
         $data['c_personid'] = $id;
         $data = $this->toolsRepository->timestamp($data, True);
         $temp = DB::table('ALTNAME_DATA')->where([
@@ -157,7 +158,7 @@ public function update(Request $request, $id, $alt)
             return redirect()->back();
         }
         $data = $request->all();
-        $data = array_except($data, ['_method', '_token']);
+        $data = Arr::except($data, ['_method', '_token']);
         $data = $this->toolsRepository->timestamp($data);
         $alt = str_replace("--","-minus",$alt);
         //20200709聯合主鍵保留字弱點防禦函式，解析保留字。

app/Http/Controllers/BasicInformationController.php

@@ -14,6 +14,7 @@
 use App\Repositories\YearRangeRepository;
 use Carbon\Carbon;
 use Illuminate\Http\Request;
+use Illuminate\Support\Arr;
 use Illuminate\Support\Facades\Auth;
 
 use App\Pinyin;
@@ -236,7 +237,7 @@ public function Duplicate_Collateral_Info($id)
         foreach ($addr as $addr_data) {
             $addr_data = (array)$addr_data;
             $addr_data['c_personid'] = $new_id;
-            $addr_data = array_except($addr_data, ['_token']);
+            $addr_data = Arr::except($addr_data, ['_token']);
             $addr_data = $this->toolRepository->timestamp($addr_data, True); //建檔資訊
             DB::table('BIOG_ADDR_DATA')->insert($addr_data);
             $this->operationRepository->store(Auth::id(), $new_id, 1, 'BIOG_ADDR_DATA', $addr_data['c_personid']."-".$addr_data['c_addr_id']."-".$addr_data['c_addr_type']."-".$addr_data['c_sequence'], $addr_data);
@@ -249,7 +250,7 @@ public function Duplicate_Collateral_Info($id)
         foreach ($source as $source_data) {
             $source_data = (array)$source_data;
             $source_data['c_personid'] = $new_id;
-            $source_data = array_except($source_data, ['_token']);
+            $source_data = Arr::except($source_data, ['_token']);
             DB::table('BIOG_SOURCE_DATA')->insert($source_data);
             $this->operationRepository->store(Auth::id(), $new_id, 1, 'BIOG_SOURCE_DATA', $source_data['c_personid']."-".$source_data['c_textid']."-".$source_data['c_pages'], $source_data);
         }
@@ -321,7 +322,7 @@ public function Duplicate_Collateral_Info($id)
         foreach ($inst as $inst_data) {
             $inst_data = (array)$inst_data;
             $inst_data['c_personid'] = $new_id;
-            $inst_data = array_except($inst_data, ['_token']);
+            $inst_data = Arr::except($inst_data, ['_token']);
             $inst_data = $this->toolRepository->timestamp($inst_data, True); //建檔資訊
             DB::table('BIOG_INST_DATA')->insert($inst_data);
             $this->operationRepository->store(Auth::id(), $new_id, 1, 'BIOG_INST_DATA', $inst_data['c_personid']."-".$inst_data['c_inst_code']."-".$inst_data['c_inst_name_code']."-".$inst_data['c_bi_role_code'], $inst_data);
@@ -334,7 +335,7 @@ public function Duplicate_Collateral_Info($id)
         foreach ($status as $status_data) {
             $status_data = (array)$status_data;
             $status_data['c_personid'] = $new_id;
-            $status_data = array_except($status_data, ['_token']);
+            $status_data = Arr::except($status_data, ['_token']);
             $status_data = $this->toolRepository->timestamp($status_data, True); //建檔資訊
             DB::table('STATUS_DATA')->insert($status_data);
             $this->operationRepository->store(Auth::id(), $new_id, 1, 'STATUS_DATA', $status_data['c_personid'].'-'.$status_data['c_sequence'].'-'.$status_data['c_status_code'], $status_data);

app/Http/Controllers/BasicInformationEntriesController.php

@@ -8,6 +8,7 @@
 use App\TextCode;
 use Carbon\Carbon;
 use Illuminate\Http\Request;
+use Illuminate\Support\Arr;
 use Illuminate\Support\Facades\Auth;
 use Illuminate\Support\Facades\DB;
 
@@ -77,7 +78,7 @@ public function store(Request $request, $id)
         return redirect()->route('basicinformation.entries.edit', ['id' => $id, '_id' => $_id]);
         */
         $data = $request->all();
-        $data = array_except($data, ['_token']);
+        $data = Arr::except($data, ['_token']);
         $data['c_personid'] = $id;
         $data = $this->toolsRepository->timestamp($data, True);
         //20181217新增片段，api回傳值有-999需要轉為0
@@ -183,7 +184,7 @@ public function update(Request $request, $id, $id_)
         return redirect()->route('basicinformation.entries.edit', ['id'=>$id, 'id_'=>$id_]);
         */
         $data = $request->all();
-        $data = array_except($data, ['_method', '_token']);
+        $data = Arr::except($data, ['_method', '_token']);
         $data = $this->toolsRepository->timestamp($data);
         //20181217新增片段，api回傳值有-999需要轉為0
         $data['c_entry_code'] = $data['c_entry_code'] == -999 ? '0' : $data['c_entry_code'];

app/Http/Controllers/BasicInformationOfficesController.php

@@ -9,6 +9,7 @@
 use App\SocialInst;
 use Carbon\Carbon;
 use Illuminate\Http\Request;
+use Illuminate\Support\Arr;
 use Illuminate\Support\Facades\App;
 use Illuminate\Support\Facades\Auth;
 use Illuminate\Support\Facades\DB;
@@ -202,7 +203,7 @@ public function saveas($id, $cpk)
         }
         $data = $res2;
         $c_addr = $data2;
-        $data = array_except($data, ['_token', 'c_addr']);
+        $data = Arr::except($data, ['_token', 'c_addr']);
         $data['c_fy_intercalary'] = (int)($data['c_fy_intercalary']);
         $data['c_ly_intercalary'] = (int)($data['c_ly_intercalary']);
         $data['c_posting_id'] = DB::table('POSTED_TO_OFFICE_DATA')->max('c_posting_id') + 1;

app/Http/Controllers/BasicInformationSocialInstController.php

@@ -8,6 +8,7 @@
 use App\TextCode;
 use Carbon\Carbon;
 use Illuminate\Http\Request;
+use Illuminate\Support\Arr;
 use Illuminate\Support\Facades\Auth;
 use Illuminate\Support\Facades\DB;
 
@@ -146,7 +147,7 @@ public function update(Request $request, $id, $id_)
         */
 
         $data = $request->all();
-        $data = array_except($data, ['_method', '_token']);
+        $data = Arr::except($data, ['_method', '_token']);
         $data = $this->toolsRepository->timestamp($data);
         //20210804在這裡處理c_inst_code傳遞過來的值，分別儲存至c_inst_code與c_inst_name_code欄位，$c_inst_name_code預設為0
         $temp = explode("-", $data['c_inst_code']);

app/Http/Controllers/BasicInformationTextsController.php

@@ -8,6 +8,7 @@
 use App\TextCode;
 use Carbon\Carbon;
 use Illuminate\Http\Request;
+use Illuminate\Support\Arr;
 use Illuminate\Support\Facades\Auth;
 use Illuminate\Support\Facades\DB;
 
@@ -73,7 +74,7 @@ public function store(Request $request, $id)
             return redirect()->back();
         }
         $data = $request->all();
-        $data = array_except($data, ['_token']);
+        $data = Arr::except($data, ['_token']);
         $data['c_personid'] = $id;
         $data = $this->toolsRepository->timestamp($data, True);
         $temp = DB::table($this->table_name)->where([
@@ -136,7 +137,7 @@ public function update(Request $request, $id, $id_)
             return redirect()->back();
         }
         $data = $request->all();
-        $data = array_except($data, ['_method', '_token']);
+        $data = Arr::except($data, ['_method', '_token']);
         $data = $this->toolsRepository->timestamp($data);
         $temp_l = explode("-", $id_);