#[MapPropertyName]

Maps an input key name to a different PHP property name. Useful when the API uses snake_case or kebab-case keys but you prefer camelCase PHP properties, or when the key is a PHP reserved word.

Syntax

use StdOut\SimpleDataObjects\Attributes\MapPropertyName;

#[MapPropertyName('input_key')]
public readonly string $phpProperty,

Example

class PaymentData extends BaseData
{
    public function __construct(
        #[MapPropertyName('card_number')]
        public readonly string $cardNumber,

        #[MapPropertyName('expiry_date')]
        public readonly string $expiryDate,

        #[MapPropertyName('cvv_code')]
        public readonly string $cvv,
    ) {}
}

$payment = PaymentData::from([
    'card_number' => '4111111111111111',
    'expiry_date' => '12/27',
    'cvv_code'    => '123',
]);

$payment->cardNumber; // '4111111111111111'
$payment->cvv;        // '123'

Serialization

toArray() uses the input key (the mapped name), not the PHP property name:

$payment->toArray();
// [
//   'card_number' => '4111111111111111',
//   'expiry_date' => '12/27',
//   'cvv_code'    => '123',
// ]

Class-level Remapping

For systematic key transformation (snake_case ↔ camelCase), use #[TransformKeys] on the class instead of mapping each property individually.