Tạo dự án đầu tiên của bạn với NativePHP

Chào mọi người, nếu bạn đang đọc phần này, chắc hẳn bạn đã hoàn thành các bài học trước đó. Nếu chưa, vui lòng quay lại xem hướng dẫn cũ trước: Bắt đầu với NativePHP – Cài đặt Laravel – FoxDevelop. Bây giờ chúng ta sẽ cùng tạo dự án đầu tiên.

Chúng ta sẽ bắt đầu từ đầu và thiết lập một dự án hoàn toàn mới:

Tạo một thư mục trống trên máy tính để lưu tệp dự án, ví dụ: D:\phpproject

Mở CMD nhanh tại thư mục này: gõ trực tiếp cmd vào thanh địa chỉ thư mục rồi nhấn Enter; cửa sổ lệnh sẽ tự động mở và chuyển đường dẫn.

Thực thi các lệnh bên dưới:

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

Lưu ý sửa lỗi nhanh (bỏ qua phần này nếu bạn đang dùng 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)

Lỗi này xảy ra do phiên bản PHP trên máy là 8.2. Bạn cần nâng cấp lên PHP 8.3 để tiếp tục công việc.

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

Truy cập trang trên để tải PHP 8.3. Người dùng Windows 64-bit có thể tải trực tiếp gói cài đặt bên dưới:

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

Sau khi tải xong, giải nén toàn bộ tệp vào D:\php8.3. Bạn có thể chọn đường dẫn thư mục khác, chỉ cần đảm bảo chỉ sử dụng ký tự tiếng Anh.

Sau khi giải nén, đổi tên tệp cấu hình:
Đổi tên php.ini-development thành php.ini

Mở tệp php.ini và bỏ dấu chấm phẩy ở đầu các dòng để hủy chú thích.

Bỏ dấu chấm phẩy chú thích cho tất cả các mục được liệt kê ở đây (bước quan trọng):

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)

Cập nhật biến môi trường hệ thống, thay đường dẫn cũ D:\php8.2 bằng D:\php8.3.

Kiểm tra cài đặt PHP với lệnh php -v. Nếu phiên bản đúng, tiếp tục thiết lập dự án.

Tiếp tục tạo dự án NativePHP Mobile

Bây giờ chạy lại các lệnh cài đặt:

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

Nếu cài đặt thành công hoàn toàn, sẽ không hiển thị bất kỳ thông báo lỗi màu đỏ nào trên cửa sổ dòng lệnh.

Để kiểm tra trên điện thoại thật, trước tiên kết nối thiết bị với máy tính qua USB, sau đó bật Tùy chọn nhà phát triển và Gỡ lỗi USB trên điện thoại.

Sử dụng lệnh sau để kiểm tra nhanh trên thiết bị thật (Khởi chạy nhanh trên thiết bị thật: Cài ứng dụng Jump vào điện thoại, quét mã QR để kết nối gỡ lỗi, không cần biên dịch tệp APK đầy đủ):

php artisan native:jumpCode language: CSS (css)

Nếu không có thiết bị di động thật, dùng lệnh thay thế bên dưới để kiểm tra trên trình giả lập:

php artisan native:serve : Dùng để xem trước trên máy tính hoặc kiểm tra trên trình giả lập (sẽ mở cửa sổ ứng dụng riêng trên máy tính)

Khi mọi thứ hoạt động ổn, bạn sẽ thấy kết quả tương tự bên dưới sau khi chạy lệnh php artisan native:jump

php artisan native:jump

Máy chủ NativePHP Jump

Máy chủ Laravel ……………………………………………………………………. http://127.0.0.1:8000
Khởi động Laravel ………………………………………………………………… hoàn thành trong 0,42 giây (HTTP 200)

Mở http://127.0.0.1:8000 trên trình duyệt để xem nội dung ứng dụng đang chạy.