哈！伸港創作者！哈

2026年4月11日星期六

想修改 chcweb 出現的問題解決集

系列文章：
1.Ubuntu 24.04 安裝 chcweb 專案的過程記錄
2.Ubuntu 24.04 安裝 laravel 5.7 的過程記錄
3.laravel 5.7 初始相關設定與注意事項
4.想修改 chcweb 出現的問題解決集

問題一: UnexpectedValueException : The stream or file "/home/webadmin/html/chcweb/storage/logs/laravel-2026-04-11.log" could not be opened in append mode: failed to open stream: Permission denied
解決方法:
錯誤意思是 Laravel 沒辦法寫入 log 檔，通常跟 目錄權限 有關。
1.

2026年2月21日星期六

在LAMP + laravel 12 的虛擬機 ,輸入YT URL,就可下載YT 影片到自己電腦

       請參考 1.Ubuntu 24.04 安裝 laravel 12 的過程記錄，完成Ubuntu 24.04 + Apache2 + PHP 8.4 + Mariadb + Laravel 12 的相關設定。
      一、在 Ubuntu 24.04 安裝 yt-dlp：
       由於Ubuntu 24.04 內建套件通常偏舊，建議用官方 binary。
1.指令如下：
sudo apt update
sudo apt install ffmpeg -y
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp
2.測試是否安裝成功，指令：
yt-dlp --version

二、Laravel 設定
1.建立 YouTubeController.php
指令：php artisan make:controller YouTubeController
內容：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Symfony\Component\Process\Process;
use Symfony\Component\Process\Exception\ProcessFailedException;
use Illuminate\Support\Str;

class YouTubeController extends Controller
{
    public function showForm()
    {
        return view('youtube.form');
    }

    public function download(Request $request){
        $request->validate([
            'url' => 'required|url'
        ]);

        $url = $request->input('url');

        // 產生安全檔名
        $filename = Str::uuid() . '.mp4';
        $filePath = storage_path('app/downloads/' . $filename);

        try {

            $process = new Process([
                '/usr/local/bin/yt-dlp', // 改成你實際路徑
                '-f', 'mp4',
                '-o', $filePath,
                $url
            ]);

            $process->setTimeout(300); // 最多跑 5 分鐘
            $process->run();

            if (!$process->isSuccessful()) {
                throw new ProcessFailedException($process);
            }

            return response()->download($filePath)->deleteFileAfterSend(true);

        } catch (\Exception $e) {
            return back()->with('error', '下載影片失敗: ' . $e->getMessage());
        }
    }
}

2.建立 form.blade.php
路徑：resources/views/youtube/form.blade.php
內容：

<!DOCTYPE html>
<html lang="zh">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>YouTube 影片下載</title>
</head>
<body>
    <h1>下載 YouTube 影片</h1>

    @if(session('error'))
        <p style="color: red;">{{ session('error') }}</p>
    @endif

    <form action="{{ route('youtube.download') }}" method="POST">
        @csrf
        <label for="url">YouTube 影片網址:</label>
        <input type="text" id="url" name="url" required>
        <button type="submit">下載</button>
    </form>
</body>
</html>

3.寫入 web.php
路徑：routes/web.php
內容：

<?php

use Illuminate\Support\Facades\Route;
use App\Http\Controllers\YouTubeController;

Route::get('/', function () {
    return view('welcome');
});
Route::get('/youtube', [YouTubeController::class, 'showForm']);
Route::post('/youtube/download', [YouTubeController::class, 'download'])->name('youtube.download');

4.測試：http://Server IP/youtube

2026年2月8日星期日

如何客製 WinPE 映像 - 新增驅動程式、更換背景圖、新增應用程式

系列文章：
1.如何用 ADK 製作 Windows PE 開機磁碟
2.如何客製 WinPE 映像 - 新增驅動程式、更換背景圖、新增應用程式

一、用 ADK 製作 Windows PE 開機磁碟

4.在C:\ 建立資料夾WinPE，用來存放WinPE_x64.iso

mkdir C:\WinPE

copype amd64 C:\WinPE\WinPEx64

makewinpemedia /iso C:\WinPE\WinPEx64 C:\WinPE\WinPEx64.iso

二、以系統管理員身分開啟部署與映像工具環境

1.掛載映像檔指令：
dism /Mount-Image /ImageFile:"C:\WinPE\WinPEx64\media\sources\boot.wim" /index:1 /MountDir:"C:\WinPE\WinPEx64\mount"

A.先說結論：一句話 這條指令的意思是：把 boot.wim 裡的第 1 個 WinPE 映像掛載到指定資料夾，讓你可以修改 WinPE 的內容

B.各參數說明 dism Windows 內建的部署與映像管理工具用來掛載、修改、維護 Windows 映像檔（.wim、.vhd、.vhdx） /Mount-Image 告訴 DISM： =>把映像檔掛載成可存取的資料夾。掛載後，你可以像操作一般資料夾一樣： a.新增 / 刪除檔案、 b.加入驅動程式、 c.加入套件（cab / msu）、 d.調整設定。 /ImageFile:"C:\WinPE\WinPEx64\media\sources\boot.wim" 指定要掛載的 WIM 映像檔路徑："C:\WinPE\WinPEx64\media\sources\boot.wim" boot.wim 是 WinPE 或 Windows 安裝環境的映像檔，在 WinPE 製作流程中，這就是「開機後跑的那個系統」。 /index:1 指定要掛載 WIM 裡的第幾個映像。一個 .wim 檔可以包含多個映像，例如： dism /Get-WimInfo /WimFile:boot.wim 可能看到： Index 1：Microsoft Windows PE Index 2：Microsoft Windows Setup 這裡的 /index:1 表示： =>掛載第一個映像（通常是 WinPE 本體） /MountDir:"C:\WinPE\WinPEx64\mount" 指定掛載後的資料夾："C:\WinPE\WinPEx64\mount" 掛載完成後， C:\WinPE\WinPEx64\mount 就會變成一個「暫時展開的 WinPE 系統」。你可以直接進去： Windows\System32 Program Files（如果有）注意：這個資料夾： a.必須事先存在、 b.必須是空的資料夾。 2.新增驅動程式 dism /Image:"C:\WinPE\WinPEx64\mount" /Add-Driver /Driver:"C:\Drivers\Realtek\64\rt25cx21x64.inf"

A.先說結論：一句話 這條指令的意思是：將 Realtek 驅動程式加入到已掛載的 WinPE 映像檔中。
B.各參數說明 dism Windows 內建的部署與映像管理工具用來掛載、修改、維護 Windows 映像檔（.wim、.vhd、.vhdx） /Image:"C:\WinPE\WinPEx64\mount"

指定已掛載的離線 Windows 映像目錄："C:\WinPE\WinPEx64\mount"

/Add-Driver

新增驅動程式到映像檔

/Driver:"C:\Drivers\Realtek\64\rt25cx21x64.inf"

指定驅動程式的 .inf 檔案位置："C:\Drivers\Realtek\64\rt25cx21x64.inf"

注意事項：

1.以「系統管理員身分」執行

2.確認映像是否已掛載

指令：dism /Get-MountedWimInfo

3.如果資料夾裡有多個驅動檔建議使用 /Recurse，讓 DISM 自動加入資料夾內所有 INF：

指令：dism /Image:"C:\WinPE\WinPEx64\mount" /Add-Driver /Driver:"C:\Drivers\Realtek\64\rt25cx21x64.inf" /Recurse

3.列出映像內含的驅動程式(目的：檢查剛剛新增的驅動程式是否在內) dism /Image:"C:\WinPE\WinPEx64\mount" /Get-Drivers

A.先說結論：一句話 這條指令的意思是： 列出已掛載 WinPE 映像檔中的所有第三方驅動程式（不包含系統內建驅動）。
B.各參數說明 dism Windows 內建的部署與映像管理工具用來掛載、修改、維護 Windows 映像檔（.wim、.vhd、.vhdx） /Image:"C:\WinPE\WinPEx64\mount" 指定已掛載的離線 Windows 映像目錄："C:\WinPE\WinPEx64\mount"

/Get-Drivers:
顯示目前映像內已安裝的驅動清單。

注意事項：

1.以「系統管理員身分」執行

2.確認映像是否已掛載

指令：dism /Get-MountedWimInfo

3.如果想看整齊資訊

加上 /Format:Table 讓畫面更整齊：

指令：dism /Image:"C:\WinPE\WinPEx64\mount" /Get-Drivers /Format:Table

4.如果想看詳細資訊

加上 /All 會顯示包含內建驅動在內的所有驅動：

指令：dism /Image:"C:\WinPE\WinPE_x64\mount" /Get-Drivers /All

4.儲存並且卸載 WinPE 映像 dism /Unmount-Image /MountDir:"C:\WinPE\WinPE_x64\mount" /Commit A.先說結論：一句話 這條指令的意思是： 把剛剛加入的驅動正式寫回 WIM 檔，並卸載映像檔。
B.各參數說明 dism Windows 內建的部署與映像管理工具用來掛載、修改、維護 Windows 映像檔（.wim、.vhd、.vhdx） /Unmount-Image 卸載已掛載的映像 /MountDir:"C:\WinPE\WinPE_x64\mount" 指定掛載目錄：C:\WinPE\WinPE_x64\mount"

/Commit 儲存變更 5. 創建 WinPE ISO 映像檔 makewinpemedia /iso C:\WinPE\WinPEx64 C:\WinPE\WinPE_custom.iso

A.先說結論： 這條指令的意思是：

將 C:\WinPE\WinPEx64 目錄中的 WinPE 建置內容，

製作成一個 ISO 映像檔，輸出為 C:\WinPE\WinPE_custom.iso

B.各參數說明

makewinpemedia

ADK 工具，用來產生：

a.開機 USB

b.開機 ISO

/iso

指定輸出格式為 ISO 映像檔，（另一個常用的是 /ufd，做 USB）

C:\WinPE\WinPEx64

來源資料夾，也就是 copype 建好的那個 WinPE 專案。

C:\WinPE\WinPEx64_custom.iso

輸出的 ISO 檔案路徑與名稱，完成後可以：

a.用虛擬機測試、

b.燒錄光碟、

c.丟進 PXE / iDRAC / iLO。

資料來源：
1.如何客製 WinPE 映像 - 新增驅動程式、更換背景圖、新增應用程式
2.Windows WIM映像入門#1 FFU映像 vs WIM映像，建立練習環境
3.Windows WIM映像入門#2 製作可開機的WinPE隨身碟或ISO
4.Windows WIM映像入門#3 sysprep初始化與建立WIM映像檔
5.Windows WIM映像入門#4 套用WIM映像檔
6.Windows FFU映像入門#5 套用FFU映像

如何用 ADK 製作 Windows PE 開機磁碟

系列文章：
1.如何用 ADK 製作 Windows PE 開機磁碟
2.如何客製 WinPE 映像 - 新增驅動程式、更換背景圖、新增應用程式

如何使用 Microsoft Assessment and Deployment Kit (ADK) 製作 Windows PE (Windows 預先安裝環境) 開機媒體。

1.下載及安裝 Windows ADK:

https://learn.microsoft.com/zh-tw/windows-hardware/get-started/adk-install

取得adksetup.exe 與 adkwinpesetup.exe

2.執行 adksetup.exe

3.執行 adkwinpesetup.exe

4.在C:\ 建立資料夾WinPE，用來存放WinPE_x64.iso

mkdir C:\WinPE

copype amd64 C:\WinPE\WinPEx64

makewinpemedia /iso C:\WinPE\WinPEx64 C:\WinPE\WinPEx64.iso

三行合在一起的意思，整體流程一句話版：

1.建立WinPE 專案資料夾

2.建立 64 位元 WinPE 環境與 boot.wim

3.把WinPE 打包成可開機的 ISO

各指令解釋：

A.mkdir C:\WinPE

Q:在做什麼？

=>建立一個資料夾：C:\WinPE

Q:用途？

=>當作 WinPE 專案的根目錄，

之後 x64 / x86 / ARM64 的 WinPE 都可以放在這裡，

純粹是準備資料夾，和 WinPE 本身還沒直接關係。

B.copype amd64 C:\WinPE\WinPEx64

Q:在做什麼？

=>使用 Windows ADK 的 copype 工具，

建立一個 64 位元（x64 / amd64）WinPE 工作環境。

參數拆解

copype

ADK 內建指令，

用來「複製 + 初始化」WinPE 必要檔案。

amd64

指定架構

代表 64 位元 x86（Intel / AMD）

常見值：

a.x86（32 位）

b.amd64（64 位）

c.arm64

C:\WinPE\WinPEx64

目標資料夾，

copype 會在這裡建立完整結構。

copype 產生的內容（重點），

執行後會出現：

C:\WinPE\WinPEx64\

├─ media\ ← 未來會變成 ISO / USB 的內容

│ ├─ boot\

│ ├─ efi\

│ └─ sources\

│ └─ boot.wim ← WinPE 映像（超重要）

│

├─ fwfiles\

└─ mount\ ← 之後掛載 boot.wim 用

=> boot.wim 就是你剛剛用 DISM 掛載的那個檔案。

C.makewinpemedia /iso C:\WinPE\WinPEx64 C:\WinPE\WinPEx64.iso

Q:在做什麼？

=>把剛剛準備好的 WinPE 專案，

打包成一個可開機的 ISO 檔。

參數拆解

makewinpemedia

ADK 工具，

用來產生：

a.開機 USB

b.開機 ISO

/iso

指定輸出格式為 ISO 映像檔，

（另一個常用的是 /ufd，做 USB）

C:\WinPE\WinPEx64

來源資料夾，

也就是 copype 建好的那個 WinPE 專案。

C:\WinPE\WinPEx64.iso

輸出的 ISO 檔案路徑與名稱，

完成後你可以：

a.用虛擬機測試、

b.燒錄光碟、

c.丟進 PXE / iDRAC / iLO。

資料來源：

1.如何用 ADK 製作 Windows PE 開機磁碟

2.Windows WIM映像入門#1 FFU映像 vs WIM映像，建立練習環境
3.Windows WIM映像入門#2 製作可開機的WinPE隨身碟或ISO
4.Windows WIM映像入門#3 sysprep初始化與建立WIM映像檔
5.Windows WIM映像入門#4 套用WIM映像檔
6.Windows FFU映像入門#5 套用FFU映像

只要點兩下，升級電腦後完成所有驅動程式的安裝

最近電腦需要升級，需要將原先Windows 10 升級到Windows 11。過去，總是要依據原先主機的型號，到原廠官方網站。將驅動程式一個個下載好。等到windows升級完成，再將驅動程式一個個裝好。總覺得很累人，是否有方式能夠讓我只要點兩下，升級電腦後完成所有驅動程式的安裝

下載檔案。解壓密碼：demo1234

使用步驟教學：

單機測試步驟：

1.下載檔案，解壓縮。解壓密碼：demo1234

2.匯出驅動設定檔->點選ExportDriverConf.bat

3.將桌面整個InstallDriver資料夾搬到隨身碟

4.升級Windows 11

5.將隨身碟內InstallDriver資料夾搬到桌面

6.匯入驅動設定檔->點選ImportDriverConf.bat

程式目的：匯出所有驅動設定檔inf 到所在的資料夾內的config

程式名稱：ExportDriverConf.bat

程式內容：

@echo off

REM ---------------以下是程式碼,不需更改---------------

>nul 2>&1 "%SYSTEMROOT%\system32\cacls.exe" "%SYSTEMROOT%\system32\config\system"

if '%errorlevel%' NEQ '0' (

echo Requesting administrative privileges...

goto UACPrompt

) else ( goto gotAdmin )

:UACPrompt

echo Set UAC = CreateObject^("Shell.Application"^) > "%temp%\getadmin.vbs"

echo UAC.ShellExecute "%~s0", "", "", "runas", 1 >> "%temp%\getadmin.vbs"

"%temp%\getadmin.vbs"

exit /B

:gotAdmin

if exist "%temp%\getadmin.vbs" del "%temp%\getadmin.vbs"

pushd "%CD%"

CD /D "%~dp0"

echo ===============================

echo 正在匯出驅動程式（Dism）

echo 匯到：%~dp0config

echo ===============================

if not exist "%~dp0config" mkdir "%~dp0config"

dism /online /export-driver /destination:"%~dp0config"

echo 驅動匯出完成

pause

exit

程式目的：匯入config資料夾內所有驅動設定檔inf

程式名稱：ImportDriverConf.bat

程式內容：

@echo off

>nul 2>&1 "%SYSTEMROOT%\system32\cacls.exe" "%SYSTEMROOT%\system32\config\system"

if '%errorlevel%' NEQ '0' (

echo Requesting administrative privileges...

goto UACPrompt

) else ( goto gotAdmin )

:UACPrompt

echo Set UAC = CreateObject^("Shell.Application"^) > "%temp%\getadmin.vbs"

echo UAC.ShellExecute "%~s0", "", "", "runas", 1 >> "%temp%\getadmin.vbs"

"%temp%\getadmin.vbs"

exit /B

:gotAdmin

if exist "%temp%\getadmin.vbs" del "%temp%\getadmin.vbs"

CD /D "%~dp0"

echo ===============================

echo 正在匯入驅動程式（PnPUtil）

echo 來源：%~dp0config

echo ===============================

if not exist "%~dp0config" (

echo 找不到 config 資料夾！

pause

exit

)

pnputil /add-driver "%~dp0config\*.inf" /subdirs /install

echo.

echo 驅動匯入完成

echo 建議重新開機

pause

exit

資料來源：
1.如何在 Windows 系統中將驅動程式匯入和匯出到另一台電腦

2026年2月1日星期日

只要點兩下，就能夠將所有照片分成橫式（landscape）、直式（portrait）與正方形(square) 並依照設定調整尺寸

系列文章：
1.只要點兩下，就能夠將所有照片分成橫式（landscape）、直式（portrait）與正方形(square) 並依照設定調整尺寸1.https://skjhcreator.blogspot.com/2026/02/landscapeportraitsquare.html

經常要處理大量照片，所以希望有個程式能夠方便批次修改照片尺寸。首先該程式能夠依據設定，調整尺寸。然後分類照片，分成橫式照片、直式照片與正方形照片。
所以，只要將未整理的照片通通放進input 資料夾內，修改設定。接下來，我只要點兩下程式，程式就會幫我調整照片尺寸，再分類照片。

下載檔案。解壓密碼：demo1234
使用步驟：

一、安裝套件 pillow
指令：pip install pillow

二、判別程式

from PIL import Image

def check_image_orientation(image_path):
    with Image.open(image_path) as img:
        width, height = img.size

        if width > height:
            return "橫照片（Landscape）"
        elif width < height:
            return "直照片（Portrait）"
        else:
            return "正方形照片（Square）"

# 範例使用
image_path = "test.jpg"
result = check_image_orientation(image_path)
print(result)

三、設定.txt 內容：

# 照片調整方式 1.強制拉伸 2.等比例縮放
1
# 調整尺寸 800x600
1000x800

=>設定內容說明：
   代表：強制拉伸（不等比例）
   目標尺寸：
   橫式 → 1000 x 800   直式 → 800 x 1000   正方形 → 1000 x 1000

四、pyPicTo800x600.py 內容：

import os
from PIL import Image

current_directory = os.getcwd()
current_directory_input = current_directory + "\\input\\"
current_directory_input_files = os.listdir(current_directory_input)

# 讀取設定.txt
with open(current_directory + "\\設定.txt", "r", encoding="utf-8") as f:
    lines = f.readlines()

# 設定 1.變形調整 2.等比例縮放
option = int(lines[1].strip())

# 尺寸 800x600
setWidth, setHeight = map(int, lines[3].strip().split('x'))

# 建立輸出資料夾
Output_landscape_path = current_directory + "\\Output_橫式\\"
Output_portrait_path  = current_directory + "\\Output_直式\\"
Output_square_path    = current_directory + "\\Output_正方形\\"

os.makedirs(Output_landscape_path, exist_ok=True)
os.makedirs(Output_portrait_path, exist_ok=True)
os.makedirs(Output_square_path, exist_ok=True)

for i in current_directory_input_files:
    with Image.open(current_directory_input + i) as img:
        width, height = img.size
        # 橫式
        if width > height:
            if option == 1:
                img = img.resize((setWidth, setHeight),Image.LANCZOS)
            elif option == 2:
                img.thumbnail((setWidth, setHeight))
            img.save(Output_landscape_path + i)
        # 直式
        elif width < height:
            if option == 1:
                img = img.resize((setHeight, setWidth),Image.LANCZOS)
            elif option == 2:
                img.thumbnail((setHeight, setWidth))
            img.save(Output_portrait_path + i)
        # 正方形
        else:
            maxvalue = max(setWidth, setHeight)
            if option == 1:
                img = img.resize((maxvalue, maxvalue),Image.LANCZOS)
            elif option == 2:
                img.thumbnail((maxvalue, maxvalue))
            img.save(Output_square_path + i)

2026年1月26日星期一

Laravel 12 CSV 匯入與雙向查詢系統

一、系統定位
本系統使用 Laravel 12 建立一套 CSV 匯入系統，同時兼顧 資料驗證、安全性、API 設計與效能可將學生帳號資料寫入資料庫，並支援以「年班座號」查詢帳號或以「帳號」反查年班座號

二、功能清單
1.CSV 上傳 UI（Blade）
2.資料驗證（CSV 欄位、重複資料）
3.密碼加密（Hash）
4.API 回傳時隱藏密碼
5.RESTful API 設計
6.錯誤處理（找不到資料）

三、建立 Laravel 12 專案

指令：composer create-project laravel/laravel csv-demo

cd csv-demo

四、建立資料表 create_student_accounts_table

指令：php artisan make:migration create_student_accounts_table

編輯 database/migrations/xxxx_create_student_accounts_table.php
=>為了提升查詢效能，針對查詢欄位建立 unique index

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    /**
     * Run the migrations.
     */
    public function up(): void
    {
        Schema::create('student_accounts', function (Blueprint $table) {
            $table->id();
            $table->string('grade_class_seat_no')->unique()->index();
            $table->string('account')->unique()->index();
            $table->string('password');
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     */
    public function down(): void
    {
        Schema::dropIfExists('student_accounts');
    }
};

五、建立Model StudentAccount

指令：php artisan make:model StudentAccount
編輯 app/Models/StudentAccount.php
=>API 回傳時自動隱藏密碼，避免敏感資料外洩

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class StudentAccount extends Model
{
    //
    protected $fillable = [
        'grade_class_seat_no',
        'account',
        'password',
    ];

    protected $hidden = [
        'password',
    ];
}

六、建立Controller StudentAccountController

指令：php artisan make:controller StudentAccountController

編輯 app/Http/Controllers/StudentAccountController.php
=> 使用 Hash::make 保護密碼

使用 firstOrFail 統一錯誤處理

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Hash;
use App\Models\StudentAccount;

class StudentAccountController extends Controller
{
    /**
     * CSV 匯入（Web + API 共用）
     */
    public function import(Request $request)
    {
        $request->validate([
            'csv' => 'required|file|mimes:csv,txt',
        ]);

        $file = $request->file('csv');
        $handle = fopen($file->getRealPath(), 'r');

        $header = fgetcsv($handle);

        if ($header !== ['GradeClassSeatNo', 'Account', 'Password']) {
            return back()->withErrors(['CSV 欄位格式錯誤']);
        }

        $count = 0;

        while (($row = fgetcsv($handle)) !== false) {
            $data = array_combine($header, $row);

            StudentAccount::updateOrCreate(
                ['grade_class_seat_no' => $data['GradeClassSeatNo']],
                [
                    'account' => $data['Account'],
                    'password' => Hash::make($data['Password']),
                ]
            );

            $count++;
        }

        fclose($handle);

        /**
         * 判斷來源：Web or API
         */
        if ($request->is('api/*')) {
            return response()->json([
                'message' => 'CSV 匯入完成',
                'count'   => $count,
            ]);
        }

        return redirect('/import-page')
            ->with('success', "匯入成功，共 {$count} 筆資料");
    }

    /**
     * 用年班座號查（API）
     */
    public function findBySeat($seatNo)
    {
        return StudentAccount::where('grade_class_seat_no', $seatNo)
            ->firstOrFail();
    }

    /**
     * 用帳號查（API）
     */
    public function findByAccount($account)
    {
        return StudentAccount::where('account', $account)
            ->firstOrFail();
    }

    /**
     * Blade 查詢頁
     */
    public function search(Request $request)
    {
        $request->validate([
            'seat_no' => 'nullable|string',
            'account' => 'nullable|string',
        ]);

        $student = null;

        if ($request->filled('seat_no')) {
            $student = StudentAccount::where(
                'grade_class_seat_no',
                $request->seat_no
            )->first();
        }

        if ($request->filled('account')) {
            $student = StudentAccount::where(
                'account',
                $request->account
            )->first();
        }

        return view('search', compact('student'));
    }
}

七、建立路由與 Api 路由

同一個匯入邏輯同時支援 Web 與 API，但依照請求來源回傳不同格式，兼顧 UX 與 API 設計。

編輯 routes/web.php

<?php
use Illuminate\Support\Facades\Route;
use App\Http\Controllers\StudentAccountController;

Route::get('/', function () {
    return view('index');
});

// CSV 匯入頁
Route::get('/import-page', function () {
    return view('import');
});
Route::post('/import', [StudentAccountController::class, 'import'])
    ->name('students.import');

// 查詢頁
Route::get('/search', function () {
    return view('search');
});

Route::post('/search', [StudentAccountController::class, 'search']);

編輯 routes/api.php

<?php

use Illuminate\Support\Facades\Route;
use App\Http\Controllers\StudentAccountController;

Route::prefix('students')->group(function () {
    Route::post('/import', [StudentAccountController::class, 'import']);
    Route::get('/seat/{seatNo}', [StudentAccountController::class, 'findBySeat']);
    Route::get('/account/{account}', [StudentAccountController::class, 'findByAccount']);
});

八、建立Blade 上傳頁面與 Blade 查詢頁面

編輯 resources/views/import.blade.php

<!DOCTYPE html>
<html>
<head>
    <title>CSV 匯入</title>
</head>
<body>
<h2>學生帳號 CSV 匯入</h2>

<form action="{{ route('students.import') }}" method="POST" enctype="multipart/form-data">
    @csrf
    <input type="file" name="csv" required>
    <button type="submit">匯入</button>
</form>

@if ($errors->any())
    <p style="color:red">{{ $errors->first() }}</p>
@endif
@if (session('success'))
    <p style="color:green">{{ session('success') }}</p>
@endif
</body>
</html>

編輯 resources/views/search.blade.php

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>學生帳號查詢系統</title>
    <style>
        body {
            font-family: Arial;
            margin: 40px;
        }
        input {
            padding: 6px;
            width: 250px;
        }
        button {
            padding: 6px 12px;
        }
        .box {
            margin-bottom: 20px;
        }
        .result {
            margin-top: 20px;
            padding: 15px;
            border: 1px solid #ccc;
        }
        .error {
            color: red;
        }
    </style>
</head>
<body>

<h2>學生帳號查詢（Demo）</h2>

<form method="POST" action="/search">
    @csrf

    <div class="box">
        <label>GradeClassSeatNo：</label><br>
        <input type="text" name="seat_no" placeholder="例如：30101">
    </div>

    <div class="box">
        <label>Account：</label><br>
        <input type="text" name="account" placeholder="例如：student01">
    </div>

    <button type="submit">查詢</button>
</form>

{{-- 查詢結果 --}}
@if(isset($student) && $student)
    <div class="result">
        <h4>查詢結果</h4>
        <p><strong>GradeClassSeatNo：</strong> {{ $student->grade_class_seat_no }}</p>
        <p><strong>Account：</strong> {{ $student->account }}</p>
    </div>
@endif

{{-- 查無資料 --}}
@if(isset($student) && !$student)
    <p class="error">查無資料</p>
@endif
{{-- 顯示錯誤訊息 --}}
@if ($errors->any())
    <ul class="error">
        @foreach ($errors->all() as $error)
            <li>{{ $error }}</li>
        @endforeach
    </ul>
@endif

</body>
</html>

編輯 resources/views/index.blade.php

<!DOCTYPE html>
<html lang="zh-TW">
<head>
    <meta charset="UTF-8">
    <title>首頁</title>
</head>
<body>
    <h1>學生帳號管理系統</h1>

    <ul>
        <li>
            <a href="{{ url('/import-page') }}">CSV 匯入學生資料</a>
        </li>
        <li>
            <a href="{{ url('/search') }}">查詢學生資料</a>
        </li>
    </ul>
</body>
</html>

訂閱：意見 (Atom)

標籤

2026年4月11日 星期六

2026年2月21日 星期六

2026年2月8日 星期日

2026年2月1日 星期日

2026年1月26日 星期一

2026年4月11日星期六

2026年2月21日星期六

2026年2月8日星期日

2026年2月1日星期日

2026年1月26日星期一