FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

Document the real parsing, nesting, comment, escape and validation rules by GrahamCampbell · Pull Request #609 · vlucas/phpdotenv · GitHub

Document the real parsing, nesting, comment, escape and validation rules - #609

Merged
GrahamCampbell merged 5 commits into
masterfrom
docs/behaviour-clarifications
Aug 24, 2026
Merged

Document the real parsing, nesting, comment, escape and validation rules#609
GrahamCampbell merged 5 commits into
masterfrom
docs/behaviour-clarifications

Conversation

GrahamCampbell commented Aug 24, 2026
edited
Loading

Copy link
Copy Markdown
Collaborator

Several parser and loader behaviours that generate recurring questions were undocumented or described inaccurately, including how undefined and braceless nested variables resolve, that a hash begins a comment inside an unquoted value, which backslash escapes are valid inside double quotes, that byte order and getenv population differ from the tagline, and how immutability, the file options and parse-versus-load actually behave. This documents them, corrects the validation examples to match the real messages, and fixes a garbled sentence in the upgrading guide. This is stacked on #615.

GrahamCampbell force-pushed the docs/behaviour-clarifications branch from 5980ec1 to 96eb03a Compare August 24, 2026 01:01
GrahamCampbell force-pushed the tests/coverage-hardening branch 2 times, most recently from a21b352 to 60feb0b Compare August 24, 2026 10:45
GrahamCampbell force-pushed the docs/behaviour-clarifications branch from 96eb03a to 0747e73 Compare August 24, 2026 10:45
GrahamCampbell force-pushed the tests/coverage-hardening branch from 60feb0b to 21cd0f5 Compare August 24, 2026 13:25
GrahamCampbell changed the base branch from tests/coverage-hardening to fix/comment-multiline-priority August 24, 2026 13:26
GrahamCampbell force-pushed the docs/behaviour-clarifications branch from 0747e73 to 249d61b Compare August 24, 2026 13:26
GrahamCampbell force-pushed the fix/comment-multiline-priority branch from 28b36d6 to 3437eeb Compare August 24, 2026 17:28
GrahamCampbell force-pushed the docs/behaviour-clarifications branch from 249d61b to 7c4d726 Compare August 24, 2026 17:28
GrahamCampbell force-pushed the fix/comment-multiline-priority branch from 3437eeb to 1411d10 Compare August 24, 2026 17:43
GrahamCampbell force-pushed the docs/behaviour-clarifications branch from 7c4d726 to 38229c3 Compare August 24, 2026 17:43
GrahamCampbell force-pushed the fix/comment-multiline-priority branch from 1411d10 to 445763b Compare August 24, 2026 17:46
GrahamCampbell force-pushed the docs/behaviour-clarifications branch from 38229c3 to e301a32 Compare August 24, 2026 17:46
GrahamCampbell force-pushed the fix/comment-multiline-priority branch from 445763b to 2e18096 Compare August 24, 2026 17:47
GrahamCampbell force-pushed the docs/behaviour-clarifications branch from e301a32 to 9db8148 Compare August 24, 2026 17:47
GrahamCampbell force-pushed the fix/comment-multiline-priority branch from 2e18096 to fe56ffc Compare August 24, 2026 17:49
GrahamCampbell force-pushed the docs/behaviour-clarifications branch from 9db8148 to 3711d78 Compare August 24, 2026 17:49
GrahamCampbell force-pushed the fix/comment-multiline-priority branch from fe56ffc to 7a62b85 Compare August 24, 2026 17:56
GrahamCampbell force-pushed the docs/behaviour-clarifications branch from 3711d78 to b70ea90 Compare August 24, 2026 17:56
GrahamCampbell force-pushed the fix/comment-multiline-priority branch from 7a62b85 to a2d162e Compare August 24, 2026 17:57
GrahamCampbell force-pushed the docs/behaviour-clarifications branch from b70ea90 to 860d89a Compare August 24, 2026 17:57
GrahamCampbell force-pushed the fix/comment-multiline-priority branch from a2d162e to 9fbee84 Compare August 24, 2026 18:03
GrahamCampbell force-pushed the docs/behaviour-clarifications branch from 860d89a to b216f12 Compare August 24, 2026 18:03
GrahamCampbell force-pushed the fix/comment-multiline-priority branch from 9fbee84 to 527062b Compare August 24, 2026 18:04
GrahamCampbell force-pushed the docs/behaviour-clarifications branch from b216f12 to 7f6f3bd Compare August 24, 2026 18:04
Base automatically changed from fix/comment-multiline-priority to master August 24, 2026 18:04
GrahamCampbell force-pushed the docs/behaviour-clarifications branch from 7f6f3bd to ac48f57 Compare August 24, 2026 18:04
GrahamCampbell merged commit 5d0bb3b into master Aug 24, 2026
44 checks passed
GrahamCampbell deleted the docs/behaviour-clarifications branch August 24, 2026 18:06
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
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.

1 participant


Back | FazBrowse Home | New Git URL