NativePHP 教學 – FoxDevelop https://www.foxdevelop.com 獨立軟體開發工作室 Sat, 04 Jul 2026 09:59:08 +0000 zh-TW hourly 1 https://wordpress.org/?v=7.1 https://www.foxdevelop.com/wp-content/uploads/2026/05/fox-svgrepo-com-1.png NativePHP 教學 – FoxDevelop https://www.foxdevelop.com 32 32 頁面視圖 WebView https://www.foxdevelop.com/zh-tw/2026/07/04/%e9%a0%81%e9%9d%a2%e8%a6%96%e5%9c%96-webview/ https://www.foxdevelop.com/zh-tw/2026/07/04/%e9%a0%81%e9%9d%a2%e8%a6%96%e5%9c%96-webview/#respond Sat, 04 Jul 2026 09:59:08 +0000 https://www.foxdevelop.com/?p=3239 上一堂課我們認識了頁面UI的對應位置，這堂課接續往下學習。

認識單一原生網頁檢視元件（WebView）

所有以 NativePHP 開發的行動裝置App，皆以單一原生網頁檢視元件（WebView）作為核心載體。透過網頁檢視元件，你能使用任何熟悉的前端網頁技術建構應用介面（UI）；因為本質上它就是內嵌瀏覽器，負責渲染所有網頁內容。

WebView 預設會填滿整個螢幕可視範圍；但若開啟相機等功能時，相機操作畫面會暫時覆蓋 WebView。

NativePHP 的核心架構：PHP 後端 + 任意前端技術混合開發（Vue、jQuery、Tailwind 等）

WebView 永遠置頂顯示，僅相機、內建瀏覽器等全螢幕場景會遮蓋它，我們看見的所有介面UI都由 WebView 負責呈現。

NativePHP 行動版底層核心：單一 WebView 容器，不具原生多頁面分層機制；也就是 NativePHP 自始至終只存在單一個頁面，頁面跳轉、返回動作全都在同一個 WebView 內完成。

NativePHP 行動App全程只會存在唯一一個原生 WebView 控制項，整支App所有畫面渲染都放在這一個網頁容器當中：

  • 頁面跳轉、路由切換、返回上一頁、彈窗、子頁面、SPA切換，完全不會建立、開啟第二個 WebView；此設計目的是降低記憶體耗用。
  • 不存在 Android / iOS 原生多頁堆疊、原生 Activity / ViewController 分頁機制；
  • 我們所看見的「多個頁面」，實際上只是前端路由（Laravel / Livewire / Vue Router 等）在同一個 WebView 內切換 DOM，運作邏輯與網頁單頁應用完全相同。

1 檢視區域 Viewport 設定（透過 meta 標籤控制螢幕適配）

有開發行動網頁經驗的開發者，應該都對這個設定不陌生。

WebView 與一般瀏覽器一樣具備 Viewport 檢視區域概念，代表頁面可顯示範圍，透過 meta 標籤設定，語法與傳統網頁完全一致。

<meta name="viewport" content="width=device-width, initial-scale=1">

請在你的 HTML 或 Blade PHP 頁面內加入這組 meta 標籤。現今多數網站都會配置這段語法，目的是讓網頁完美適配行動裝置瀏覽器；若缺少這組設定，頁面文字會顯得細小模糊。主因是手機螢幕 DPI 解析度極高，未做行動適配時頁面會以電腦版瀏覽器規格渲染，造成字體過細、排版混亂等狀況。

各位可隨意開啟網站示範，以 NativePHP 官方文件頁面為例：Web View – NativePHP mobile v3 – NativePHP，於瀏覽器右鍵檢視網頁原始碼即可看見該標籤。

這組設定包含兩個核心屬性：

width=device-width：頁面寬度等同裝置實體螢幕寬度

initial-scale=1：頁面初始縮放比例為1:1，不自動放大或縮小

2 停用雙指縮放（模擬原生App操作體感）

原生 Android、iOS App 預設無法透過雙指張開/收合放大縮小頁面，但一般行動瀏覽器允許此操作。若要讓 NativePHP 頁面體感更接近原生App，必須關閉手動縮放功能，避免使用者隨意調整畫面大小。

開發行動App時，通常需要完整掌控介面顯示，禁止使用者手動縮放頁面，讓應用操作邏輯與純原生App一致。

於原本的 viewport 標籤追加以下屬性：

<meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">

user-scalable=no：關閉手動縮放手勢

3 全螢幕邊緣渲染 Edge-to-Edge（瀏海/曲面螢幕適配前置設定）

為最大化UI設計彈性，WebView 預設會填滿整塊螢幕，僅透過 HTML/CSS/JS 就能在前台狀態任意位置繪製內容。

但需留意：螢幕並非全部區域都能正常顯示內容。多數裝置具備前置鏡頭瀏海、螢幕圓角、曲面邊緣，蘋果裝置另有動態島；這些區域雖屬於檢視區範圍，卻會遮蓋內容、無法點擊操作。

若要完整適配異形螢幕，需在 meta Viewport 標籤加入 viewport-fit=cover，並搭配安全邊距（Safe Area Insets）樣式使用。

<meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no, viewport-fit=cover">

viewport-fit=cover：允許頁面渲染延伸至螢幕最邊緣（包含瀏海、圓角區域）；僅開啟此參數仍會造成內容被瀏海遮擋，務必搭配「安全區 Safe Area」CSS樣式，請繼續往下閱讀。

安全區 Safe Areas

安全區定義為螢幕不會被遮擋的可視範圍：不會被硬體結構（螢幕圓角、前置鏡頭瀏海、動態島）、系統常駐介面（底部Home手勢列、狀態列）遮蓋。

裝置執行時會自動計算安全區邊界，並隨直橫螢幕切換動態調整；NativePHP 透過一組內建 CSS 變數即可實現跨裝置自適應排版。

<!-- 為 body 加入全域安全區約束 -->
<body class="nativephp-safe-area">
    <!-- 頂部導覽列左右預留螢幕圓角邊距 -->
    <div class="fixed top-0 left-0 w-full bg-red-500 pl-[var(--inset-left)] pr-[var(--inset-right)]">
        頂部導覽列
    </div>
</body>
  • --inset-top 頂部安全間距（狀態列 / 瀏海高度）
  • --inset-bottom 底部安全間距（手勢操作列高度）
  • --inset-left 左側曲面/圓角安全邊距
  • --inset-right 右側曲面/圓角安全邊距

以上幾組 CSS 變數皆由 NativePHP Mobile 官方內建，框架會自動載入，不需額外引入第三方CSS函式庫。

快捷全域 CSS 類別：nativephp-safe-area

可直接於 HTML 根容器標籤加上此類別，自動將內容限制在安全區範圍內，大幅簡化開發流程，參考上方範例程式碼。

我們透過範例對照差異，先以官方示範理解原理，後續再使用實機測試。首先示範未做安全區適配的狀況：

<div class="fixed top-0 left-0 w-full bg-red-500">
    ...
</div>

從上圖可見，頂部標題列直接被前置鏡頭瀏海覆蓋。

若切換為橫向模式，狀況會更糟，如下圖：

橫屏狀態下，畫面左右兩側出現大片空白，頂部標題列無法填滿整個橫向螢幕，視覺上相當不美觀。

若加上安全區設定，於 body 標籤套用官方內建樣式：

<body class="nativephp-safe-area">
<div class="fixed top-0 left-0 w-full bg-red-500 pl-[var(--inset-left)] pr-[var(--inset-right)]">
    ...
</div>

介面立刻完整填滿螢幕，美觀度大幅提升。

程式碼修改實作

接著修改上一堂課使用的範例檔案 welcome.blade.php

替換 body 內完整內容，範例使用 Tailwind 前端UI框架，語法類似 Bootstrap。

<!DOCTYPE html>
<html lang="{{ str_replace('_', '-', app()->getLocale()) }}">
    <head>
        <meta charset="utf-8">
        <meta name="viewport" content="width=device-width, initial-scale=1">

        <title>{{ config('app.name', 'Mimi') }} - Built with NativePHP ： welcome to foxdevelop.com</title>

    </head>
    <body>
        <div class="fixed top-0 left-0 w-full bg-red-500">
			頂部導覽列
		</div>
    </body>
</html>

儲存檔案後，開啟命令提示字元切換至專案根目錄，執行下方指令：

php artisan native:jump
D:\phpproject\my-app>php artisan native:jump

開發預覽網址：http://127.0.0.1:8000

僅透過電腦瀏覽器無法觀察行動裝置適配效果，必須使用實機執行測試。

實機偵錯流程

開發 Android App 流程相同：準備一台 Android 手機、透過傳輸線連接電腦，手機需開啟開發者模式；若不清楚開啟方式可上網查詢，步驟簡單。另外需安裝 ADB 工具，此為 Google 提供、電腦遠端操作手機的工具，安裝 Android Studio 時會一併自帶。

安裝完整 Android Studio，確保同步安裝 Android SDK、SDK Platform Tools（內含 ADB 偵錯工具）

確認 ADB 安裝正常：

開啟終端機輸入指令：adb devices

D:\phpproject\my-app>adb devices
List of devices attached
a34354354354352    device

上列範例代表已有手機成功連線。

切換至專案資料夾，於 CMD 執行以下指令編譯並安裝Android App：php artisan native:run android

D:\phpproject\my-app>php artisan native:run android

  Running NativePHP for Android

 Build log: D:\phpproject\my-app\nativephp\android-build.log

  Updating Android configuration ....................................................................... 903.01ms DONE
  Copying Laravel source .................................................................................... 18s DONE
  Installing Composer dependencies

編譯流程會自動安裝多項相依套件，包含 Kotlin、Gradle 等，因此需確保網路連線穩定。

若網路需透過代理，可修改專案內設定檔路徑：D:\phpproject\my-app\nativephp\android\gradle\wrapper\gradle-wrapper.properties

將 Gradle 下載位址替換為國內鏡像站台，範例如下：

#Mon Feb 10 07:33:27 EST 2025
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
#distributionUrl=https\://services.gradle.org/distributions/gradle-8.13-bin.zip
distributionUrl=https\://mirrors.aliyun.com/maven/gradle/gradle-8.13-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
]]> https://www.foxdevelop.com/zh-tw/2026/07/04/%e9%a0%81%e9%9d%a2%e8%a6%96%e5%9c%96-webview/feed/ 0 resources 資料夾 https://www.foxdevelop.com/zh-tw/2026/06/16/resources-%e8%b3%87%e6%96%99%e5%a4%be/ https://www.foxdevelop.com/zh-tw/2026/06/16/resources-%e8%b3%87%e6%96%99%e5%a4%be/#respond Tue, 16 Jun 2026 01:13:24 +0000 https://www.foxdevelop.com/?p=1912 上一堂課我們透過 NativePHP 建立了一個預設專案，並在瀏覽器開啟該應用，預設網址為：http://127.0.0.1:8000/

這個頁面本質上就是一般網頁，這點不用懷疑。NativePHP 的介面畫面，全部都是靠 HTML、CSS、JS 來實作。那要怎麼自訂修改這個介面呢？

介面相關的程式檔案，全都放在專案根目錄下的 resources 資料夾

以作者自身環境為例，完整路徑如下：

D:\phpproject\my−app\resourcesD:\phpproject\my-app\resources

打開資料夾後，會看見底下有幾個子目錄：

其中 css 用來存放樣式檔、js 則是放置腳本程式，views 資料夾內存放頁面用的 PHP 樣板檔，進到 views 裡可以看見這些檔案

接著打開 welcome.blade.php 這個檔案，

檔案內有一段程式碼長這樣

是不是很眼熟？這裡就是專案的 PHP 樣板程式。接下來我們實際動手修改看看

舉例來說，我們找到頁面內的副標題區段：

<p class="subtitle">Your app is ready.</p>

在文字後面多加一段內容：

<p class="subtitle">Your app is ready.welcome to foxdevelop.com</p>

儲存檔案後，重新整理頁面 http://127.0.0.1:8000/

此時就能看見畫面的副標題已經替換成我們剛才修改的文字，各位讀者可以自己跟著操作試試。NativePHP 不會綁定任何前端技術，不會限制你使用任何開發工具或框架，像是 Livewire、Vue、React、Svelte、HTMX 甚至 jQuery 全都能搭配使用。

這堂課請大家先找到專案裡的 resources 資料夾，嘗試自行修改樣板內容，藉此熟悉 NativePHP 的基礎架構。後續章節我們會以這個 UI 介面為基礎，展開更詳細的完整教學。

]]> https://www.foxdevelop.com/zh-tw/2026/06/16/resources-%e8%b3%87%e6%96%99%e5%a4%be/feed/ 0 NativePHP 桌面版介紹與環境建置 https://www.foxdevelop.com/zh-tw/2026/06/09/nativephp-%e6%a1%8c%e9%9d%a2%e7%89%88%e4%bb%8b%e7%b4%b9%e8%88%87%e7%92%b0%e5%a2%83%e5%bb%ba%e7%bd%ae/ https://www.foxdevelop.com/zh-tw/2026/06/09/nativephp-%e6%a1%8c%e9%9d%a2%e7%89%88%e4%bb%8b%e7%b4%b9%e8%88%87%e7%92%b0%e5%a2%83%e5%bb%ba%e7%bd%ae/#respond Tue, 09 Jun 2026 00:44:10 +0000 https://www.foxdevelop.com/?p=1628 這是一套全新的框架，專為開發原生桌面應用程式所打造。無論你是資深開發人員或是入門新手，都能輕鬆上手使用 NativePHP 開發應用。全球越來越多開發者開始採用這項技術。透過 PHP 開發原生桌面軟體，你可以沿用原本熟悉的核心技術：HTML、CSS、JavaScript 以及 PHP 本身。

為何選擇 PHP？

PHP 是一門發展超過三十年、技術極為成熟的程式語言，經過長期實務場域的驗證與優化。目前多數網站皆以 PHP 作為後端技術，其中全球使用最廣泛的開源網站建置工具 WordPress，更是 PHP 最具代表性的成功案例。過去 PHP 長期專注於網頁開發，如今隨著 NativePHP 這類專案出現，也正式拓展至桌面與行動應用開發領域。

NativePHP 究竟是什麼？

  • 一組實用函式庫，可讓 PHP 程式碼與底層作業系統無縫互動。
  • 多項輔助工具，用來編譯與封裝完成後的原生應用程式。
  • 獨立執行的靜態 PHP 執行環境，封裝後的應用程式可直接在各裝置執行，使用者無需手動額外安裝執行環境。

何謂 Laravel？

Laravel 是一套熱門的 PHP 框架。簡單來說，框架就是以 PHP 撰寫完成的現成開發架構；基於框架開發，能夠避免重複編寫基礎程式碼，大幅提升開發效率。

和多數常見的桌面、行動開發框架不同，NativePHP 並非原生介面框架，不會直接繪製作業系統原生介面控制項。它是以內嵌瀏覽器引擎作為執行基礎，這樣的設計讓你能夠自由選用各種前端技術組合：原生 HTML 與 CSS、React、Vue、Tailwind CSS、Bootstrap、Material UI 等皆完全支援。

NativePHP 內建豐富功能，可滿足多數常見開發需求：

  • 原生視窗管理
  • 系統與應用程式選單控制
  • 本機檔案系統操作
  • 內建 SQLite 資料庫整合
  • 原生桌面推播通知

使用 NativePHP 能夠開發哪些類型的應用？

幾乎所有你能想到的類型都可行，例如行程排程工具、螢幕錄影軟體以及各式各樣的桌面實用工具。

桌面版 NativePHP 已正式上線，可直接用於商業正式環境。

環境建置與安裝

請確認本機環境符合以下所有必備條件：

  1. PHP 8.3 以上版本
  2. Laravel 11 以上版本
  3. Node.js 22 以上版本
  4. Windows 10、macOS 12 或其他主流 Linux 發行版
  5. Composer

關於 PHP 與 Node.js

為確保開發流程順暢，建議直接在本機開發電腦安裝 PHP 與 Node.js。

為什麼需要安裝 Node.js？

桌面版 NativePHP 基於 Electron 開發，而 Electron 必須依賴 Node.js 與 npm 來安裝前端相依套件，並封裝最終的應用程式資源檔。

安裝 Node.js 相當簡單：前往官方網站下載安裝程式，接著按照一般桌面軟體的安裝精靈步驟執行即可。

依照上方清單完成開發環境設定後，下一單元就會開始引導你建立第一支 NativePHP 桌面應用程式。

]]> https://www.foxdevelop.com/zh-tw/2026/06/09/nativephp-%e6%a1%8c%e9%9d%a2%e7%89%88%e4%bb%8b%e7%b4%b9%e8%88%87%e7%92%b0%e5%a2%83%e5%bb%ba%e7%bd%ae/feed/ 0 建立你的第一個 NativePHP 專案 https://www.foxdevelop.com/zh-tw/2026/06/08/%e5%bb%ba%e7%ab%8b%e4%bd%a0%e7%9a%84%e7%ac%ac%e4%b8%80%e5%80%8b-nativephp-%e5%b0%88%e6%a1%88/ https://www.foxdevelop.com/zh-tw/2026/06/08/%e5%bb%ba%e7%ab%8b%e4%bd%a0%e7%9a%84%e7%ac%ac%e4%b8%80%e5%80%8b-nativephp-%e5%b0%88%e6%a1%88/#respond Mon, 08 Jun 2026 13:36:21 +0000 https://www.foxdevelop.com/?p=1599 各位好，如果你來到這個章節，想必已經完成前面的課程。若尚未學習，請先回顧我們先前的教學：NativePHP 快速入門 – 安裝 Laravel – FoxDevelop。接下來我們將一步步建立第一個專案。

我們會從零開始，全新建立一個專案：

在電腦上建立空白資料夾來存放專案檔案，範例：D:\phpproject

快速在此路徑開啟命令提示字元：直接在資料夾網址列輸入 cmd 後按下 Enter，視窗就會自動開啟並切換至該目錄。

執行以下指令：

composer create-project --prefer-dist nativephp/mobile-starter my-app
cd my-app
php artisan native:jump

快速問題排除（若你使用 PHP 8.3 可略過此段落）

composer create-project --prefer-dist nativephp/mobile-starter my-app
Creating a "nativephp/mobile-starter" project at "./my-app"
Installing nativephp/mobile-starter (1.0.4)
  - Downloading nativephp/mobile-starter (1.0.4)
  - Installing nativephp/mobile-starter (1.0.4): Extracting archive
Created project in D:\phpproject\my-app
> @php -r "file_exists('.env') || copy('.env.example', '.env');"
Loading composer repositories with package information
Updating dependencies
Your requirements could not be resolved to an installable set of packages.

  Problem 1
    - Root composer.json requires nativephp/mobile ^3.0 -> satisfiable by nativephp/mobile[3.0.0, ..., 3.3.5].
    - nativephp/mobile[3.0.0, ..., 3.3.5] require php ^8.3 -> your php version (8.2.31) does not satisfy that requirement.

發生此錯誤是因為本機 PHP 版本為 8.2，必須升級至 PHP 8.3 才能繼續作業。

https://windows.php.net/download#php-8.3

前往該網頁下載 PHP 8.3。Windows 64 位元使用者可直接取用下方安裝套件：

https://downloads.php.net/~windows/releases/archives/php-8.3.31-nts-Win32-vs16-x64.zip

下載完成後，將所有檔案解壓縮至 D:\php8.3。你也可以自訂路徑，僅需確認路徑全部使用英文字元即可。

解壓縮完畢後，重新命名設定檔：
將 php.ini-development 更名為 php.ini

開啟 php.ini，刪除開頭的分號以取消註解：

移除以下所有項目的分號註解（此步驟至關重要）：

extension_dir = "ext"
extension=curl
extension=gd
extension=mbstring
extension=mysqli
extension=pdo_mysql
extension=zip
extension=openssl
extension=fileinfo
extension=sqlite3
extension=pdo_sqlite

更新系統環境變數，將舊的 D:\php8.2 路徑替換為 D:\php8.3。

執行 php -v 確認 PHP 版本，版本無誤後即可繼續建立專案。

繼續建立 NativePHP 行動裝置專案

現在再次執行安裝指令：

composer create-project --prefer-dist nativephp/mobile-starter my-app
cd my-app

安裝成功時，終端機不會出現任何紅色錯誤訊息。

若要在實體手機測試，請先透過 USB 將裝置連接電腦，接著在手機中開啟開發人員選項與 USB 偵錯模式。

使用下方指令快速在實體裝置測試（實機快速啟動：在手機安裝 Jump 應用程式，掃描 QR Code 即可連線偵錯，無需完整編譯 APK）：

php artisan native:jump

若沒有實體行動裝置，可改用下列指令在模擬器測試：

php artisan native:serve ：適用桌面預覽或模擬器測試（會在電腦開啟獨立應用視窗）

執行 php artisan native:jump 且一切正常運作時，你會看到類似以下的執行結果

php artisan native:jump

NativePHP Jump 伺服器

Laravel 伺服器 ……………………………………………………………………. http://127.0.0.1:8000
Laravel 載入完成 ………………………………………………………………… 耗時 0.42 秒 (HTTP 200)

使用瀏覽器開啟 http://127.0.0.1:8000 即可檢視執行中的應用內容。

]]> https://www.foxdevelop.com/zh-tw/2026/06/08/%e5%bb%ba%e7%ab%8b%e4%bd%a0%e7%9a%84%e7%ac%ac%e4%b8%80%e5%80%8b-nativephp-%e5%b0%88%e6%a1%88/feed/ 0 Getting Started with NativePHP: Install Laravel https://www.foxdevelop.com/zh-tw/2026/06/08/getting-started-with-nativephp-install-laravel-2/ https://www.foxdevelop.com/zh-tw/2026/06/08/getting-started-with-nativephp-install-laravel-2/#respond Mon, 08 Jun 2026 10:09:47 +0000 https://www.foxdevelop.com/?p=1545 NativePHP 可讓你無需耗費大量時間設定 Xcode 或 Android Studio。你只需要在 iOS 或 Android 裝置安裝 Jump 應用程式即可。

Laravel – 開發者專用的精簡開發框架

執行下列指令以建立全新 Laravel 專案

laravel new my-app --using=nativephp/mobile-starter
 
cd my-app
 
php artisan native:jump

備註：執行這些指令前，請先安裝好 Laravel。

如何安裝 Laravel？

Laravel 到底是什麼？

Laravel 是一款人氣極高、易於使用的 PHP 網站框架。內建帳號登入與註冊、檔案上傳、信件發送、資料庫操作及表單驗證等工具，能大幅加快 PHP 開發速度。

由於 Laravel 仰賴 PHP 執行，請先完成 PHP 環境建置。另外請留意版本規範，舊版 PHP 無法執行新版 Laravel。

PHP 版本 ≥ 8.1（建議使用 8.2 ~ 8.4）

安裝 PHP

請參考這篇專屬教學來安裝 PHP：

安裝 PHP 環境 – FoxDevelop

安裝 Composer

Composer 是 PHP 的套件管理工具，類似 .NET 的 NuGet 或是 Java 的 Maven、Gradle。

安裝步驟請參考另一篇獨立教學。

安裝 PHP 套件管理工具 Composer – FoxDevelop

確認 PHP 與 Composer 皆安裝完成後，接下來就能開始安裝 Laravel。

開啟命令提示字元，先檢查軟體版本。

PHP 版本需求：PHP ≥ 8.1（優選 8.2 / 8.5），執行 php -v 查看版本

Composer 版本需求：Composer ≥ 2.5，執行 composer -V 查看版本

接著檢查必要的 PHP 擴充功能：

php -m | findstr mbstring
php -m | findstr openssl
php -m | findstr pdo

中國地區使用者可切換至阿里雲鏡像來解決下載緩慢問題。請在命令提示字元貼上以下指令：

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

接著使用 create-project 指令開始安裝：

composer create-project laravel/laravel myproject
cd myproject

這裡因為缺少 zip 擴充功能而出現錯誤。如果你的安裝流程順利，可跳過下方除錯步驟，直接前往此處。

錯誤訊息如下：

C:\Users\xxxx>composer create-project laravel/laravel myproject
Creating a "laravel/laravel" project at "./myproject"
Installing laravel/laravel (v12.10.0)
    Failed to download laravel/laravel from dist: The zip extension and unzip/7z commands are both missing, skipping.
The php.ini used by your command-line PHP is: D:\php8.2\php.ini
    Now trying to download from source
  - Syncing laravel/laravel (v12.10.0) into cache

在命令提示字元執行下列指令，確認 zip 擴充功能未安裝：

php -m | findstr zip

若沒有任何輸出，代表 zip 擴充功能尚未啟用。

編輯 php.ini 以啟用 zip 擴充功能

我的 PHP 設定檔路徑：D:\php8.2\php.ini

找到 ;extension=zip，刪除開頭的分號。

再次在命令提示字元執行 php -m | findstr zip，出現內容即代表擴充功能已正常啟用。

隨後重新執行安裝作業

再次執行安裝指令：

composer create-project laravel/laravel myproject

安裝再度失敗，執行紀錄如下：

composer create-project laravel/laravel myproject
Creating a "laravel/laravel" project at "./myproject"
Installing laravel/laravel (v12.10.0)
  - Downloading laravel/laravel (v12.10.0)
    Failed downloading laravel/laravel, trying the next URL (404: The "https://mirrors.aliyun.com/composer/dists/laravel/laravel/76396a056d552b8a34077f151775037ac44b431a.zip" file could not be downloaded (HTTP/2 404 ))
  - Downloading laravel/laravel (v12.10.0)
  - Installing laravel/laravel (v12.10.0): Extracting archive
Created project in C:\Users\maiwu\myproject
> @php -r "file_exists('.env') || copy('.env.example', '.env');"
Loading composer repositories with package information
Updating dependencies
Your requirements could not be resolved to an installable set of packages.

  Problem 1
    - Root composer.json requires laravel/tinker ^2.10.1, it is satisfiable by laravel/tinker[v2.10.1, v2.10.2, v2.11.0, v2.11.1] from composer repo (https://repo.packagist.org) but laravel/tinker[2.x-dev] from composer repo (https://mirrors.aliyun.com/composer) has higher repository priority. The packages from the higher priority repository do not match your minimum-stability and are therefore not installable. That repository is canonical so the lower priority repo's packages are not installable. See https://getcomposer.org/repoprio for details and assistance.
  Problem 2
    - Root composer.json requires phpunit/phpunit ^11.5.3, found phpunit/phpunit[11.5.3, ..., 11.5.44] but these were not loaded, because they are affected by security advisories ("PKSA-z3gr-8qht-p93v", "PKSA-z3gr-8qht-p93v"). Go to https://packagist.org/security-advisories/ to find advisory details. To ignore the advisories, add them to the audit "ignore" config. To turn the feature off entirely, you can set "block-insecure" to false in your "audit" config.
  Problem 3
    - Root composer.json requires laravel/sail ^1.41 -> satisfiable by laravel/sail[v1.41.0, ..., v1.46.0].
    - laravel/sail[v1.41.0, ..., v1.46.0] require symfony/yaml ^6.0|^7.0 -> found symfony/yaml[v6.0.0, ..., v6.4.30, v7.0.0, ..., v7.4.1] but these were not loaded, because they are affected by security advisories ("PKSA-v5yj-8nmz-sk2q", "PKSA-ft77-7h5f-p3r6", "PKSA-b14r-zh1d-vdrc", "PKSA-v5yj-8nmz-sk2q", "PKSA-ft77-7h5f-p3r6", "PKSA-b14r-zh1d-vdrc"). Go to https://packagist.org/security-advisories/ to find advisory details. To ignore the advisories, add them to the audit "ignore" config. To turn the feature off entirely, you can set "block-insecure" to false in your "audit" config.
  Problem 4
    - Root composer.json requires laravel/framework ^12.0 -> satisfiable by laravel/framework[v12.1.1, ..., v12.40.0].
    - laravel/framework[v12.1.1, ..., v12.12.0] require league/commonmark ^2.6 -> found league/commonmark[2.6.0] but these were not loaded, because they are affected by security advisories ("PKSA-21fb-n1x5-5nf7", "PKSA-2cx9-ynrq-qdk3", "PKSA-rqc2-tcc6-nc79", "PKSA-21fb-n1x5-5nf7", "PKSA-2cx9-ynrq-qdk3", "PKSA-rqc2-tcc6-nc79"). Go to https://packagist.org/security-advisories/ to find advisory details. To ignore the advisories, add them to the audit "ignore" config. To turn the feature off entirely, you can set "block-insecure" to false in your "audit" config.
    - laravel/framework[v12.13.0, ..., v12.40.0] require league/commonmark ^2.7 -> satisfiable by league/commonmark[2.7.0, ..., 2.8.2] from composer repo (https://repo.packagist.org) but league/commonmark[dev-main, 2.7.x-dev, 2.8.x-dev, 2.9.x-dev (alias of dev-main)] from composer repo (https://mirrors.aliyun.com/composer) has higher repository priority. The packages from the higher priority repository do not match your minimum-stability and are therefore not installable. That repository is canonical so the lower priority repo's packages are not installable. See https://getcomposer.org/repoprio for details and assistance.

原因：阿里雲 Composer 鏡像站點異常。

先刪除異常的專案資料夾，再切換回官方來源：

rmdir /s /q myproject
composer config -g --unset repos.packagist
composer create-project laravel/laravel myproject --no-audit

安裝依然失敗，請再次清理殘留檔案：

- Downloading phpunit/php-code-coverage (11.0.12)
  - Downloading phar-io/version (3.2.1)
  - Downloading phar-io/manifest (2.0.4)
  - Downloading myclabs/deep-copy (1.13.4)
  - Downloading phpunit/phpunit (11.5.55)
 110/111 [===========================>]  99%A connection timeout was encountered. If you intend to run Composer without connecting to the internet, run the command again prefixed with COMPOSER_DISABLE_NETWORK=1 to make Composer run in offline mode.
    Failed to download laravel/pint from dist: The "https://codeload.github.com/laravel/pint/legacy.zip/0770e9b7fafd50d4586881d456d6eb41c9247a80" file could not be written to C:\Users\maiwu\myproject/vendor/composer/tmp-60f6b8b4815321558e13bb1ac74423ee.zip: Failed to open stream: Permission denied
    Now trying to download from source
  - Syncing laravel/pint (v1.29.1) into cache
Cloning failed using an ssh key for authentication, enter your GitHub credentials to access private repos
You need to provide a GitHub access token.
Tokens will be stored in plain text in "C:/Users/maiwu/AppData/Roaming/Composer/auth.json" for future use by Composer.
Due to the security risk of tokens being exfiltrated, use tokens with short expiration times and only the minimum permissions necessary.

Carefully consider the following options in order:

1. When you don't use 'vcs'  type 'repositories'  in composer.json and do not need to clone source or download dist files
from private GitHub repositories over HTTPS, use a fine-grained token with read-only access to public information.
Use the following URL to create such a token:
https://github.com/settings/personal-access-tokens/new?name=Composer+on+DESKTOP-1OHC5Q4+2026-05-27+0946

2. When all relevant _private_ GitHub repositories belong to a single user or organisation, use a fine-grained token with
repository "content" read-only permissions. You can start with the following URL, but you may need to change the resource owner
to the right user or organisation. Additionally, you can scope permissions down to apply only to selected repositories.
https://github.com/settings/personal-access-tokens/new?contents=read&name=Composer+on+DESKTOP-1OHC5Q4+2026-05-27+0946

3. A "classic" token grants broad permissions on your behalf to all repositories accessible by you.
This may include write permissions, even though not needed by Composer. Use it only when you need to access
private repositories across multiple organisations at the same time and using directory-specific authentication sources
is not an option. You can generate a classic token here:
https://github.com/settings/tokens/new?scopes=repo&description=Composer+on+DESKTOP-1OHC5Q4+2026-05-27+0946

For additional information, check https://getcomposer.org/doc/articles/authentication-for-private-packages.md#github-oauth
Token (hidden):

接著執行修改後的安裝指令：

composer create-project laravel/laravel myproject --no-dev --no-audit

使用此指令安裝可避免跳出 GitHub 權杖提示，並略過額外相依套件：
加入 –no-dev 與 –no-audit 參數，跳過會觸發 GitHub 原始碼下載的 pint、phpunit 套件。

出現類似以下內容即代表安裝成功：

- Installing league/commonmark (2.8.2): Extracting archive
  - Installing laravel/framework (v12.61.0): Extracting archive
75 package suggestions were added by new dependencies, use `composer suggest` to see details.
Package sebastian/code-unit is abandoned, you should avoid using it. No replacement was suggested.
Package sebastian/code-unit-reverse-lookup is abandoned, you should avoid using it. No replacement was suggested.
Generating optimized autoload files
> Illuminate\Foundation\ComposerScripts::postAutoloadDump
> @php artisan package:discover --ansi

   INFO  Discovering packages.

  laravel/tinker .............................................................................................................................. DONE
  nesbot/carbon ............................................................................................................................... DONE
  nunomaduro/termwind ......................................................................................................................... DONE

接下來測試剛建立的專案，上述指令會自動建立 myproject 資料夾並存放所有原始檔。

在目前的命令提示字元視窗中執行以下兩行指令：

cd myproject
php artisan serve

命令提示字元畫面會顯示如下：

C:\Users\xxxx>cd myproject
C:\Users\xxxx\myproject>php artisan serve
   INFO  Server running on [http://127.0.0.1:8000].
   Press Ctrl+C to stop the server

將 http://127.0.0.1:8000 貼到瀏覽器網址列，即可看到 Laravel 預設首頁。

]]> https://www.foxdevelop.com/zh-tw/2026/06/08/getting-started-with-nativephp-install-laravel-2/feed/ 0 安裝 Composer，PHP 套件管理工具 https://www.foxdevelop.com/zh-tw/2026/06/08/%e5%ae%89%e8%a3%9d-composer%ef%bc%8cphp-%e5%a5%97%e4%bb%b6%e7%ae%a1%e7%90%86%e5%b7%a5%e5%85%b7/ https://www.foxdevelop.com/zh-tw/2026/06/08/%e5%ae%89%e8%a3%9d-composer%ef%bc%8cphp-%e5%a5%97%e4%bb%b6%e7%ae%a1%e7%90%86%e5%b7%a5%e5%85%b7/#respond Mon, 08 Jun 2026 09:48:21 +0000 https://www.foxdevelop.com/?p=1517 Composer 是 PHP 官方的套件管理工具。

使用瀏覽器前往此頁面：https://getcomposer.org/download/，找到 Windows 安裝程式 並下載 Composer-Setup.exe 安裝檔。

在安裝檔上按滑鼠右鍵，選擇以系統管理員身分執行。

安裝程式會在設定過程中自動偵測 PHP 資料夾。若無法自動辨識路徑，請手動選取 PHP 目錄。

此處維持核取方塊不勾選，接著直接使用預設設定並持續點選下一步。

工具會嘗試自動選取 PHP 安裝目錄，若自動偵測失敗，請手動指定路徑。

接下來會出現代理伺服器設定頁面，請直接跳過此步驟。

持續點選下一步，直到出現完成按鈕，即可結束安裝程序。

接著驗證安裝結果，開啟命令提示字元並執行下方指令：

C:\Users\xxxx>composer --version
Composer version 2.9.8 2026-05-13 09:28:38
PHP version 8.2.31 (D:\php8.2\php.exe)
Run the "diagnose" command to get more detailed diagnostics output.

若畫面顯示如上範例的版本資訊，即代表安裝成功。至此 Composer 就已設定完畢。

]]> https://www.foxdevelop.com/zh-tw/2026/06/08/%e5%ae%89%e8%a3%9d-composer%ef%bc%8cphp-%e5%a5%97%e4%bb%b6%e7%ae%a1%e7%90%86%e5%b7%a5%e5%85%b7/feed/ 0 設定 PHP 環境 https://www.foxdevelop.com/zh-tw/2026/06/08/%e8%a8%ad%e5%ae%9a-php-%e7%92%b0%e5%a2%83-2/ https://www.foxdevelop.com/zh-tw/2026/06/08/%e8%a8%ad%e5%ae%9a-php-%e7%92%b0%e5%a2%83-2/#respond Mon, 08 Jun 2026 09:12:01 +0000 https://www.foxdevelop.com/?p=1491 安裝 PHP

首先前往官方下載頁面取得 PHP：https://windows.php.net/download/

選擇 PHP 8.2（建議版本）並下載 ZIP 壓縮檔。

你可以直接點擊此下載連結：PHP：下載頁面

往下捲動頁面，點選 zip 下載選項。

為什麼不選 PHP 8.5？截至 2026 年，較新的 PHP 版本可能會與 Laravel 產生相容性問題。就學習用途來說，PHP 8.2 搭配 Laravel 12 是最佳組合；此組合執行穩定、錯誤少，且網路上有豐富的教學資源。待你完成本課程時，PHP 8.5 或許已趨於成熟，可依自身狀況調整版本。

下載完成後，解壓 php-8.2.31-nts-Win32-vs16-x64.zip 檔案並開始進行設定。

將 php-8.2.31-nts-Win32-vs16-x64.zip 解壓縮至路徑簡短、不含中文字元與空格的資料夾，範例：D:\php8.2

開啟解壓後的資料夾，會看見分別對應開發環境與正式環境的兩組設定檔。

找到以下兩個檔案：

  • php.ini-development（本機開發專用）
  • php.ini-production（線上伺服器專用，暫時不需更動）

先備份 php.ini-development，再將其中一份重新命名為 php.ini。

使用記事本開啟 php.ini，修改數項參數設定。

  • 找到 ;extension_dir = “ext” 這一行，移除開頭的分號；
  • 移除 Laravel 所需擴充功能前方的分號，啟用所有必要擴充：
extension=curl
extension=fileinfo
extension=mbstring
extension=openssl
extension=pdo_mysql

儲存修改後的 php.ini 檔案。

重要步驟：將 D:\php8.2 資料夾路徑新增至系統環境變數。

從開始選單搜尋環境變數，接著編輯 Path 內容。

接下來驗證 PHP 安裝狀態，開啟一般命令提示字元視窗。

執行指令：php -v

php -v

若畫面上顯示 PHP 版本資訊，代表安裝作業順利完成。

出現以上資訊即表示電腦中的 PHP 已正確安裝完畢。

]]> https://www.foxdevelop.com/zh-tw/2026/06/08/%e8%a8%ad%e5%ae%9a-php-%e7%92%b0%e5%a2%83-2/feed/ 0 NativePHP 入門：初步介紹 https://www.foxdevelop.com/zh-tw/2026/06/07/nativephp-%e5%85%a5%e9%96%80%ef%bc%9a%e5%88%9d%e6%ad%a5%e4%bb%8b%e7%b4%b9/ https://www.foxdevelop.com/zh-tw/2026/06/07/nativephp-%e5%85%a5%e9%96%80%ef%bc%9a%e5%88%9d%e6%ad%a5%e4%bb%8b%e7%b4%b9/#respond Sun, 07 Jun 2026 10:11:52 +0000 https://www.foxdevelop.com/?p=1292 顧名思義，NativePHP 就是原生 PHP，意指可在本機執行的 PHP 應用程式。長久以來，PHP 大多用於網頁開發，所有程式碼都在遠端伺服器上執行。NativePHP 徹底改變了這種運作模式，開發人員現在可以使用它來開發原生桌面軟體，以及適用於 Android 與 iOS 的行動應用程式。

你可以在此瀏覽官方網站：Baking Delicious Native Apps – NativePHP

NativePHP 的運作方式為何？

其原理並不繁雜，核心概念和多數應用程式大同小異。傳統 PHP 仰賴遠端伺服器上的直譯器執行，而 NativePHP 會將 PHP 執行環境直接封裝在最終的 EXE 檔案或應用安裝檔內。該專案團隊也針對內建執行環境進行最佳化，提升整體執行效能。

以下為官方架構圖：

NativePHP 會把完整的 PHP 執行環境與你的應用程式整合在一起。行動應用會透過 Swift 或 Kotlin 進行封裝，桌面軟體則使用 Electron 建置。此平台透過專屬橋接介面存取硬體功能，並藉由內建的原生 WebView 顯示應用介面。你仍可使用標準 PHP 進行開發，只需新增數個擴充功能，就能連接裝置原生功能。概念相當簡單：你所有的 PHP 程式碼都會直接在使用者的裝置本機執行。

從左側架構圖可見，每一個 NativePHP 應用都由 Swift 或 Kotlin 外層程式碼包裹，內部包含完整的 PHP 執行環境與自訂 PHP 擴充功能。

圖中標示的自訂 PHP 擴充功能，是讓 PHP 能夠呼叫系統原生功能的核心元件，也是專為 NativePHP 打造的專用 PHP 外掛程式。它接收 PHP 送出的請求，轉交給底層的 Swift 或 Kotlin 橋接程式碼來執行實際的系統指令，而系統回傳的資料也會透過同一個擴充功能傳回 PHP。

這項自訂擴充功能不可或缺。缺少它，NativePHP 就無法運作，我們也不可能使用 PHP 開發本機應用程式。

使用者透過原生 WebView 檢視所有內容，這是內嵌在應用程式中的輕量級瀏覽器引擎，用來載入 PHP 與 HTML 頁面。它並非完整版 Chrome，只是封裝在成品應用當中的瀏覽器元件。

至此，相信你已經對 NativePHP 有基礎認識。我們會先從行動應用開發開始教學，後續再介紹桌面開發的相關內容。

]]> https://www.foxdevelop.com/zh-tw/2026/06/07/nativephp-%e5%85%a5%e9%96%80%ef%bc%9a%e5%88%9d%e6%ad%a5%e4%bb%8b%e7%b4%b9/feed/ 0 NativePHP 基礎：行動版 NativePHP 簡介 https://www.foxdevelop.com/zh-tw/2026/06/07/nativephp-%e5%9f%ba%e7%a4%8e%ef%bc%9a%e8%a1%8c%e5%8b%95%e7%89%88-nativephp-%e7%b0%a1%e4%bb%8b/ https://www.foxdevelop.com/zh-tw/2026/06/07/nativephp-%e5%9f%ba%e7%a4%8e%ef%bc%9a%e8%a1%8c%e5%8b%95%e7%89%88-nativephp-%e7%b0%a1%e4%bb%8b/#respond Sun, 07 Jun 2026 07:24:54 +0000 https://www.foxdevelop.com/?p=1247 在上一堂課中，我們介紹了 NativePHP 的基礎概念。今天，我們將深入探討行動版 NativePHP。簡單來說，這個函式庫是專為建構行動應用程式而打造的。

如果你已經會使用 PHP 程式設計，就不需要學習全新的程式語言來開發 iOS 和 Android 的原生應用程式，而行動版 NativePHP 正是實現這件事的工具。它也是第一個能讓完整 PHP 程式碼在行動裝置硬體上原生執行的工具，完全不需要外部網頁伺服器。

這個工具會將預先編譯的 PHP 執行環境與 Laravel 框架一起打包進你的最終應用程式中。它也會建立與各平台原生系統 API 的無縫連結，讓開發者可以用熟悉的 PHP 語法開發真正的原生行動軟體。以這種方式建構的應用程式執行流暢，且預設就具備離線運作能力。

此框架的主要優勢

首先，它提供了真正等級的原生效能。透過行動裝置最佳化的內嵌 PHP 執行環境驅動，它與一般以網頁包裝的應用程式有根本上的不同，能提供接近完全原生軟體的使用體驗。

1. 你可以直接存取原生裝置功能。常見的硬體功能，例如裝置相機、生物辨識驗證與推播通知，都可以直接呼叫，你也可以使用平台的原生控制項來建立介面。所有功能都整合在單一函式庫中，讓開發流程更順暢。

2. 它與整個 Laravel 生態系深度整合。資深的 Laravel 開發者可以重複使用既有的技能與預建套件，不用從頭學習陌生的新框架。

3. 完全不依賴外部網頁伺服器；你的整個應用程式都在裝置本機執行，從一開始就以離線功能為設計目標。更棒的是，它支援真正的跨平台開發——只要編譯單一程式碼基底，就能產生適用於 iOS 和 Android 的個別安裝檔。

對新開發者友善的學習曲線

使用行動版 NativePHP，你不需要學習 Swift 或 Kotlin 這類冷門的行動開發語言，也不用浪費時間設定 Gradle 或 Xcode 這類複雜的建置工具。你的開發工作只需要撰寫標準 PHP 程式碼。

全球許多 PHP 開發者現在都利用他們既有的技術，更快地推出行動應用程式，大幅縮短整體開發週期。從完成原始程式碼到將應用程式提交至官方應用商店，可能只需要幾分鐘。

它如何執行與開發方式

背後的工作流程很簡單。編譯專案時，預建的 PHP 二進位檔會與你的業務邏輯一起打包進一個以 Swift 或 Kotlin 撰寫的輕量原生殼層中。內建的抽象層會管理內嵌的 PHP 執行環境，並直接執行你的 PHP 程式碼。客製化的 PHP 擴充則會將 PHP 邏輯連結到目標手機上所有可用的原生功能。

建立前端 UI 時有很高的彈性：標準的 HTML、JavaScript、Tailwind、Blade、Livewire 都能直接使用，也支援 React 和 Vue 這類熱門框架。從第 3 版開始，搭配 EDGE 就能直接使用平台原生 UI 控制項，讓應用程式的外觀與使用體驗更為真實。開發者只需要呼叫簡單的內建輔助函式，就能實作大多數所需的功能。

比標準網頁包裝應用程式更強大

很多人誤以為它只是另一個包在行動容器裡的網站，但事實完全不是如此。你應用程式的每一段程式碼都會與應用程式套件一起安裝在使用者的裝置本機上。

透過專為此打造的 PHP 擴充，大多數原生行動系統 API 都已可存取，新的整合功能也會定期新增。完整的可用功能清單請參考官方文件。

與受各種執行環境限制的 PWA 或 WebAssembly 解決方案不同，此架構提供了完全不受限制的 PHP 執行能力，不受沙箱限制，也不需要繁瑣的設定工作。它讓所有資深 PHP 開發者都能投入原生行動開發。

總而言之，如果你是計畫開發行動應用程式的 PHP 開發者，不妨試試行動版 NativePHP——你很可能會對它的能力感到驚喜。

]]> https://www.foxdevelop.com/zh-tw/2026/06/07/nativephp-%e5%9f%ba%e7%a4%8e%ef%bc%9a%e8%a1%8c%e5%8b%95%e7%89%88-nativephp-%e7%b0%a1%e4%bb%8b/feed/ 0