moai-lang-php

name	moai-lang-php
description	PHP 8.3+ development specialist covering Laravel 11, Symfony 7, Eloquent ORM, and modern PHP patterns. Use when developing PHP APIs, web applications, or Laravel/Symfony projects.
license	Apache-2.0
compatibility	Designed for Claude Code
allowed-tools	Read Grep Glob Bash(php:*) Bash(composer:*) Bash(phpunit:*) Bash(phpstan:*) Bash(phpcs:*) Bash(artisan:*) Bash(laravel:*) mcp__context7__resolve-library-id mcp__context7__get-library-docs
user-invocable	false
metadata	{"version":"1.1.0","category":"language","status":"active","updated":"2026-01-11","modularized":"true","tags":"language, php, laravel, symfony, eloquent, doctrine, phpunit"}
progressive_disclosure	{"enabled":true,"level1_tokens":100,"level2_tokens":5000}
triggers	{"keywords":["PHP","Laravel","Symfony","Eloquent","Doctrine","PHPUnit","Pest",".php","composer.json","artisan"],"languages":["php"]}

Quick Reference (30 seconds)

PHP 8.3+ Development Specialist - Laravel 11, Symfony 7, Eloquent, Doctrine, and modern PHP patterns.

Auto-Triggers: PHP files with .php extension, composer.json, artisan command, symfony.yaml, Laravel or Symfony discussions

Core Capabilities:

• PHP 8.3 Features: readonly classes, typed properties, attributes, enums, named arguments
• Laravel 11: Controllers, Models, Migrations, Form Requests, API Resources, Eloquent
• Symfony 7: Attribute-based routing, Doctrine ORM, Services, Dependency Injection
• ORMs: Eloquent for Laravel, Doctrine for Symfony
• Testing: PHPUnit, Pest, feature and unit testing patterns
• Package Management: Composer with autoloading
• Coding Standards: PSR-12, Laravel Pint, PHP CS Fixer
• Docker: PHP-FPM, nginx, multi-stage builds

Quick Patterns

Laravel Controller Pattern:

In the App\Http\Controllers\Api namespace, create a UserController extending Controller. Import StoreUserRequest, UserResource, User, and JsonResponse. Define a store method accepting StoreUserRequest that creates a User using validated data and returns a JsonResponse with UserResource wrapping the user and status 201.

Laravel Form Request Pattern:

In the App\Http\Requests namespace, create a StoreUserRequest extending FormRequest. The authorize method returns true. The rules method returns an array with name requiring required, string, and max 255 validation, email requiring required, email, and unique on users table, and password requiring required, min 8, and confirmed validation.

Symfony Controller Pattern:

In the App\Controller namespace, create a UserController extending AbstractController. Import User, EntityManagerInterface, JsonResponse, and Route attribute. Apply Route attribute at class level for api/users path. Create a create method with Route attribute for empty path and POST method. Inject EntityManagerInterface, create new User, persist and flush, then return json response with user and status 201.

---

Implementation Guide (5 minutes)

PHP 8.3 Modern Features

Readonly Classes:

Declare a readonly class UserDTO with a constructor promoting public properties for int id, string name, and string email.

Enums with Methods:

Create an OrderStatus enum backed by string. Define cases Pending with pending value, Processing with processing value, and Completed with completed value. Add a label method that uses match expression on $this to return appropriate display labels for each case.

Attributes:

Create a Validate attribute class targeting properties with Attribute attribute. The constructor accepts a string rule and optional string message. Create a UserRequest class with email property decorated with Validate attribute specifying required and email rules.