建立你的第一個 NativePHP 專案

各位好,如果你來到這個章節,想必已經完成前面的課程。若尚未學習,請先回顧我們先前的教學: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.Code language: JavaScript (javascript)

發生此錯誤是因為本機 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_sqliteCode language: JavaScript (javascript)

更新系統環境變數,將舊的 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:jumpCode language: CSS (css)

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

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 即可檢視執行中的應用內容。

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *