Translate PHP localization files with Hyperlocalise

​

Source file

<?php
return [
    'home' => [
        'title' => 'Welcome',
    ],
];

​

Configure your files

locales:
    source: en-US
    targets:
        - es-ES

buckets:
    messages:
        files:
            - from: locales/en-US/messages.php
              to: locales/{{target}}/messages.php

llm:
    profiles:
        default:
            provider: openai
            model: gpt-5.2

​

Translate

hyperlocalise run --dry-run
hyperlocalise run

​

Behavior and limitations

• Files must start with <?php and return one static [...] or array(...) literal.
• Use quoted keys and string values. Nested arrays become dotted keys.
• Comments, ordering, whitespace, quote style, and array syntax are preserved by replacing existing value literals.
• Variables, function calls, constants, declare(...), and interpolated double-quoted strings are rejected.

​

Next steps

• Check translations before committing generated files.
• Local translation workflow explains repeat runs.
• Browse all file formats.

​

Related formats

• JSON localization
• YAML localization