البدء باستخدام NativePHP: تثبيت Laravel

باستخدام NativePHP، لن تحتاج إلى قضاء وقت طويل في ضبط إعدادات Xcode أو Android Studio. كل ما عليك هو تثبيت تطبيق Jump على جهاز iOS أو Android.

Laravel – منصة تطوير متطورة للمطورين

قم بتشغيل الأوامر التالية لإنشاء مشروع Laravel جديد

laravel new my-app --using=nativephp/mobile-starter
 
cd my-app
 
php artisan native:jumpCode language: JavaScript (javascript)

ملاحظة: يجب تثبيت 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، وهو مشابه لـ NuGet في .NET أو Maven و Gradle في Java.

يمكنك الاطلاع على دليل منفصل لمعرفة خطوات التثبيت.

تثبيت Composer مدير حزم PHP – FoxDevelop

بعد الانتهاء من تثبيت PHP و Composer، يمكنك متابعة تثبيت Laravel.

افتح موجه الأوامر، وتحقق أولاً من إصدارات البرامج.

متطلبات إصدار PHP: 8.1 فما فوق (يوصى بـ 8.2 أو 8.5)، قم بتشغيل الأمر php -v للتحقق.

متطلبات إصدار Composer: 2.5 فما فوق، قم بتشغيل الأمر composer -V للتحقق.

بعد ذلك، تحقق من ملحقات PHP المطلوبة:

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

يمكن للمستخدمين داخل الصين التبديل إلى مرآة Alibaba لحل مشكلة بطء التنزيل. الصق الأمر التالي في موجه الأوامر:

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/Code language: JavaScript (javascript)

الآن ابدأ عملية التثبيت باستخدام أمر 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 cacheCode language: JavaScript (javascript)

قم بتشغيل أمر التحقق في موجه الأوامر للتأكد من عدم تفعيل ملحق 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, ..., 1.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.Code language: PHP (php)

السبب: مرآة Composer الخاصة بـ Alibaba لا تعمل بشكل طبيعي.

قم أولاً بحذف مجلد المشروع المعيب، ثم عد إلى المصدر الرسمي:

rmdir /s /q myproject
composer config -g --unset repos.packagist
composer create-project laravel/laravel myproject --no-auditCode language: PHP (php)

إذا استمر فشل التثبيت، قم بتنظيف الملفات المتبقية مرة أخرى:

- 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):Code language: PHP (php)

بعد ذلك، قم بتشغيل أمر التثبيت المعدل:

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

هذا الأمر يقوم بتثبيت Laravel دون طلب رمز وصول GitHub، ويتجاهل الحزم الإضافية:
استخدم المعاملين –no-dev و –no-audit لتخطي حزم pint و phpunit التي تقوم بتحميل الكود المصدري من GitHub.

ظهور نص مشابه لما يلي يعني اكتمال التثبيت بنجاح:

- 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 ......................................................................................................................... DONECode language: JavaScript (javascript)

الآن قم باختبار المشروع الجديد، حيث يقوم الأمر السابق بإنشاء مجلد 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
Code language: JavaScript (javascript)

الصق الرابط http://127.0.0.1:8000 في شريط العناوين بالمتصفح لمعرفة الصفحة الرئيسية الافتراضية لـ Laravel.

Previous: تثبيت Composer، مدير الحزم الخاص بلغة PHP

Next: أنشئ مشروعك الأول باستخدام NativePHP

كيفية تثبيت Laravel؟

تثبيت Composer

تعديل ملف php.ini لتفعيل ملحق zip

اترك تعليقاً إلغاء الرد