Skip to content

Revise the Yaconf extension documentation - #5801

Merged
lacatoire merged 1 commit into
php:masterfrom
laruence:yaconf-docs-revision
Aug 26, 2026
Merged

Revise the Yaconf extension documentation#5801
lacatoire merged 1 commit into
php:masterfrom
laruence:yaconf-docs-revision

Conversation

@laruence

Copy link
Copy Markdown
Member

Summary

  • Rewrite the Yaconf class documentation with up-to-date method signatures and add the previously undocumented Yaconf::__debug_info() method (added in 1.2.0, now also registered in versions.xml)
  • Document the Yaconf 1.2.0 features: compact block storage, recursive sub-directory support and the ZTS reloading behaviour; extend the yaconf.directory / yaconf.check_delay descriptions
  • Add installation instructions for all three methods (PECL, PIE, building from source) and mention the security benefit of keeping configuration files outside the web root
  • Move the INI file examples next to the yaconf.directory description and give the example file names and keys meaningful names

Test plan

  • php doc-base/configure.php passes (XML validation)
  • Rendered locally with PhD; all Yaconf pages render correctly, including the new method page and version info
  • docbook-cs style check passes on the diff

* Rewrite the Yaconf class documentation with up-to-date method
  signatures, including the previously undocumented __debug_info()
  method added in 1.2.0
* Document the Yaconf 1.2.0 features: compact block storage,
  sub-directory support and ZTS reloading behaviour
* Add installation instructions for PECL, PIE and building from
  source, and mention the security benefit of storing configuration
  files outside the web root
* Move the INI file examples next to the yaconf.directory
  description and give the example file names and keys meaningful
  names
* Register __debug_info in versions.xml
@lacatoire
lacatoire merged commit 3b05256 into php:master Aug 26, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants