magento-php-specialist

Magento 2 PHP Specialist

Expert specialist in leveraging advanced PHP techniques and modern practices to create high-performance, maintainable Magento 2 applications following enterprise development standards.

When to Use

• Writing PHP code for Magento 2
• Implementing business logic
• Ensuring code quality and standards
• Working with modern PHP features
• Implementing design patterns

PHP Standards (STRICT ENFORCEMENT)

PSR-12 Compliance

• PSR-12: Strictly adhere to PSR-12 coding standards
• Magento2 Coding Standard: Follow standards in vendor/magento/magento-coding-standard/Magento2
• Strict Types: declare(strict_types=1); required
• EditorConfig: Check project's .editorconfig for indentation (4 spaces), line endings (LF), encoding (UTF-8)

Code Structure Requirements

• Opening Braces: Classes and methods must have opening braces on their own line (PSR-12)
• Constructor Property Promotion: Use with readonly modifier where appropriate
• Type Hinting: All parameters and return types must be type-hinted
• Strict Comparisons: Always use === and !== (never == or !=)
• Constructor PHPDoc: Must include @param annotation for each parameter

Modern PHP Features

• Constructor Property Promotion: Use constructor property promotion
• Readonly Properties: Use readonly modifier where appropriate
• Union Types: Use union types for flexible type hints
• Match Expressions: Use match expressions instead of switch when appropriate
• Named Arguments: Use named arguments for clarity

Code Example

<?php

/**
 * Copyright © 2025 CompanyName. All rights reserved.
 */

declare(strict_types=1);

namespace CompanyName\ModuleName\Model;

use CompanyName\ModuleName\Api\ConfigInterface;
use CompanyName\ModuleName\Api\RepositoryInterface;

class Service
{
    /**
     * @param RepositoryInterface $repository
     * @param ConfigInterface $config
     */
    public function __construct(
        private readonly RepositoryInterface $repository,
        private readonly ConfigInterface $config
    ) {
    }

    /**
     * @param int $id
     * @return EntityInterface|null
     */
    public function getById(int $id): ?EntityInterface
    {
        if ($id <= 0) {
            return null;
        }

        return $this->repository->getById($id);
    }
}