Persian (Farsi) translation of the PHP Manual.
Status: Public release-candidate staging. This repository is not yet an official
php/*translation repository; official onboarding with the PHP Documentation Team is pending.
This repository contains the validated Persian translation tree prepared from the PHP English documentation baseline:
`ebe570978c9a476a3c68abe53426b3c363f62eb5
Publication staging commit:
`018b87e9ba2a9ae50dcd5cc4217ed0c305ca9427
- 10,973 translated Persian XML files
- 185
<?do-not-translate?>XML files intentionally omitted and supplied by the English fallback - 385 additional XML files without Persian translation intentionally omitted and supplied by the English fallback
- 10,978 tracked files in the public staging repository
- 10,973 / 10,973 translated XML files contain current
EN-Revisionmetadata with `Status: ready
The repository is intentionally sparse: untranslated files are not copied from doc-en. During an official documentation build, missing translation files fall back to the English source.
The release candidate was validated locally with the PHP documentation toolchain.
- UTF-8 / XML 1.0 / structural validation: PASS
- Residual untranslated English QA gate: PASS
- Cyrillic contamination gate: PASS
- New duplicate
xml:idgate: PASS git diff --checkon the canonical release candidate: PASS- PHP documentation tooling CI: PASS
doc-baseconfiguration: PASS- PhD XHTML render: PASS — 11,915 generated files
- PhD PHP render: PASS — 13,133 generated files
- Public staging privacy scan: PASS
- Hard secret findings: 0
The two private-key-looking strings detected during publication QA were verified as documentation examples inherited from the English PHP manual, not credentials.
PHP translation repositories contain translated files only. Files that are not yet translated are supplied from the English manual during the build.
Each translated XML file contains an EN-Revision header identifying the English source commit on which that translation is based.
Example:
<!-- EN-Revision: <english-commit> Maintainer: soroushneyestani Status: ready -->
## Upstream
English PHP documentation:
https://github.com/php/doc-en
PHP Manual:
https://www.php.net/manual/
PHP documentation translation guide:
https://doc.php.net/guide/translating.md
## Official onboarding
The next step is coordination with the PHP Documentation Team for official Persian (`fa`) translation onboarding, including the official repository/team setup, `translation.xml`, and language registration.
Until that process is completed, this repository should be considered a **community-maintained public release candidate**, not an official PHP project repository.
## Contributing
Issues and pull requests are welcome for:
- Persian translation corrections
- terminology consistency
- typographical and orthographic fixes
- synchronization with newer English documentation revisions
- documentation build or XML issues
When updating a translated XML file, its `EN-Revision` metadata must also be synchronized with the corresponding English source revision.
## Maintainer
**Soroush Neyestani**
GitHub: [@soroushneyestani](https://github.com/soroushneyestani)
## License and attribution
The PHP Manual text and comments are copyright © the PHP Documentation Group and are distributed under the **Creative Commons Attribution 3.0 License or later**.
This repository contains a Persian translation/adaptation of the PHP documentation. Original project and documentation attribution remains with the PHP Documentation Group.
License information:
https://www.php.net/manual/en/copyright.php