Laravel Pint وجودة الكود

// يأتي Pint مثبتاً مسبقاً مع Laravel 9+ // للمشاريع القديمة، قم بتثبيته: composer require laravel/pint --dev // تشغيل Pint لإصلاح أسلوب الكود ./vendor/bin/pint // التحقق بدون الإصلاح (مفيد لـ CI) ./vendor/bin/pint --test // إصلاح ملفات أو دلائل محددة ./vendor/bin/pint app/Models ./vendor/bin/pint app/Http/Controllers/UserController.php // معاينة التغييرات بدون تطبيقها ./vendor/bin/pint --dry-run // إظهار الإخراج المطول ./vendor/bin/pint -v // استخدام إعداد مسبق محدد ./vendor/bin/pint --preset psr12

// pint.json { "preset": "laravel", "rules": { "simplified_null_return": true, "braces": false, "new_with_braces": { "anonymous_class": true, "named_class": true }, "no_unused_imports": true, "ordered_imports": { "sort_algorithm": "alpha" }, "single_quote": true, "trailing_comma_in_multiline": { "elements": ["arrays"] } }, "exclude": [ "vendor", "storage", "bootstrap/cache" ] } // بديل: استخدم تكوين PHP // pint.php <?php return [ 'preset' => 'laravel', 'rules' => [ 'array_syntax' => ['syntax' => 'short'], 'binary_operator_spaces' => [ 'default' => 'single_space', ], 'blank_line_after_namespace' => true, 'blank_line_after_opening_tag' => true, 'blank_line_before_statement' => [ 'statements' => ['return'], ], ], ];

# .husky/pre-commit
#!/bin/sh
./vendor/bin/pint --test || (
    ./vendor/bin/pint
    git add .
)

// تثبيت Larastan composer require larastan/larastan --dev // إنشاء تكوين phpstan.neon // phpstan.neon includes: - vendor/larastan/larastan/extension.neon parameters: paths: - app - config - database - routes # المستوى يذهب من 0 إلى 9 (الأكثر صرامة) level: 6 # تجاهل أخطاء محددة ignoreErrors: - '#Call to an undefined method .*::factory\(\)#' # التحقق من الأنواع المفقودة checkMissingIterableValueType: false checkGenericClassInNonGenericObjectType: false # قواعد مخصصة excludePaths: - vendor - storage - bootstrap/cache // تشغيل PHPStan ./vendor/bin/phpstan analyse // إصلاح ما يمكن إصلاحه تلقائياً ./vendor/bin/phpstan analyse --generate-baseline // استخدام حد الذاكرة للمشاريع الكبيرة ./vendor/bin/phpstan analyse --memory-limit=2G

// المشكلة: الخاصية ليس لها نوع أو نوع مختلط // سيء class User extends Model { protected $fillable; } // جيد class User extends Model { /** @var array<string> */ protected $fillable = ['name', 'email']; } // المشكلة: الدالة ليس لها نوع إرجاع // سيء public function getUsers() { return User::all(); } // جيد public function getUsers(): Collection { return User::all(); } // المشكلة: لا يتم قراءة/كتابة الخاصية أبداً // استخدم تعليقات PHPStan /** @phpstan-ignore-next-line */ private $unusedProperty; // المشكلة: دالة غير محددة على نموذج Eloquent /** @var \App\Models\User $user */ $user = User::find(1); $user->posts(); // PHPStan الآن يعرف عن هذه العلاقة // أو استخدم PHPDoc على النموذج /** * @property-read \Illuminate\Database\Eloquent\Collection<Post> $posts * @method \Illuminate\Database\Eloquent\Relations\HasMany posts() */ class User extends Model { public function posts() { return $this->hasMany(Post::class); } }

// تثبيت IDE Helper composer require --dev barryvdh/laravel-ide-helper // إنشاء ملفات المساعدة php artisan ide-helper:generate php artisan ide-helper:models php artisan ide-helper:meta // إنشاء تلقائي عند تحديث composer // composer.json { "scripts": { "post-update-cmd": [ "@php artisan ide-helper:generate", "@php artisan ide-helper:models --nowrite", "@php artisan ide-helper:meta" ] } } // إضافة إلى .gitignore _ide_helper.php _ide_helper_models.php .phpstorm.meta.php // إنشاء PHPDoc للنماذج php artisan ide-helper:models --write // هذا يضيف PHPDoc إلى نماذجك: /** * App\Models\User * * @property int $id * @property string $name * @property string $email * @property \Illuminate\Support\Carbon|null $email_verified_at * @property string $password * @property-read \Illuminate\Notifications\DatabaseNotificationCollection $notifications * @property-read \Illuminate\Database\Eloquent\Collection $posts * @method static \Illuminate\Database\Eloquent\Builder|User whereEmail($value) * @method static \Illuminate\Database\Eloquent\Builder|User whereName($value) */ class User extends Authenticatable { // ... }

// Laravel Debugbar - شريط تصحيح قوي composer require barryvdh/laravel-debugbar --dev // Telescope - مساعد تصحيح أنيق لـ Laravel composer require laravel/telescope --dev php artisan telescope:install php artisan migrate // الوصول إلى Telescope // زيارة: http://your-app.test/telescope // Ray - أداة تصحيح سطح المكتب من Spatie composer require spatie/laravel-ray --dev // الاستخدام ray('تصحيح هذا'); ray($user, $posts); ray()->table($users); ray()->measure(fn() => expensive_operation()); // Clock - مساعد تصحيح لـ Laravel use Illuminate\Support\Facades\Date; Date::setTestNow('2024-01-01 12:00:00'); now(); // يرجع 2024-01-01 12:00:00 // تصحيح الاستعلامات DB::enableQueryLog(); // استعلاماتك هنا dd(DB::getQueryLog()); // أو استخدم مستمع الاستعلامات DB::listen(function ($query) { logger($query->sql, $query->bindings, $query->time); });

// سير عمل GitHub Actions // .github/workflows/laravel.yml name: Laravel CI on: push: branches: [ main, develop ] pull_request: branches: [ main, develop ] jobs: laravel-tests: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: Setup PHP uses: shivammathur/setup-php@v2 with: php-version: '8.2' extensions: mbstring, xml, bcmath coverage: xdebug - name: Copy .env run: php -r "file_exists('.env') || copy('.env.example', '.env');" - name: Install Dependencies run: composer install -q --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist - name: Generate key run: php artisan key:generate - name: Directory Permissions run: chmod -R 777 storage bootstrap/cache - name: Create Database run: | mkdir -p database touch database/database.sqlite - name: Run Pint run: ./vendor/bin/pint --test - name: Run PHPStan run: ./vendor/bin/phpstan analyse - name: Execute tests env: DB_CONNECTION: sqlite DB_DATABASE: database/database.sqlite run: php artisan test --coverage - name: Upload coverage reports uses: codecov/codecov-action@v3