53 releases (28 breaking)
| new 0.29.1 | Nov 10, 2026 |
|---|---|
| 0.28.0 | Oct 29, 2026 |
| 0.19.0 | Jul 31, 2026 |
| 0.3.2 | Mar 31, 2026 |
#45 in Programming languages
2,991 downloads per month
Used in 12 crates
(7 directly)
1.5MB
35K
SLoC
php-rs-parser
Fast, fault-tolerant PHP parser producing a typed AST with source spans. Covers PHP 7.4–8.5 syntax (plus PHP 8.6 partial function application) and recovers from syntax errors.
let result = php_rs_parser::parse("<?php echo 'Hello, world!';");
assert!(result.errors.is_empty());
println!("{:#?}", result.program);
Part of the rust-php-parser workspace. See the main README for the full guide, and docs.rs/php-rs-parser for the API reference.
License
BSD 3-Clause
lib.rs:
Fast, fault-tolerant PHP parser that produces a fully typed AST.
This crate parses PHP source code (PHP 7.4–8.5, plus PHP 8.6 partial function
application) into a php_ast::Program tree, recovering from syntax errors
so that downstream tools always receive a complete AST.
Semantic-rejection responsibility
The parser is fault-tolerant: it always produces an AST and reports every error it can identify before recovering. Its semantic-rejection responsibility is defined externally:
For any input, the parser emits at least one diagnostic iff
php -lwould reject that input at the configured target PHP version.
Flow-sensitive checks — cross-file resolution, unused variables, dead code,
type-mismatched returns — are out of scope and belong in a later semantic
layer. Checks decidable from one declaration, one parameter list, one
modifier set, or one declaration loop are in scope and use
diagnostics::ParseError::Forbidden.
The ===php_error=== section in tests/fixtures/**/*.phpt records php -l
output; the fixture runner enforces the rule above by failing CI when PHP
rejects an input that the parser silently accepts.
Quick start
let result = php_rs_parser::parse("<?php echo 'hello';");
assert!(result.errors.is_empty());
Version-aware parsing
Use parse_with and ParseOptions to target a specific PHP version.
Syntax that requires a higher version is still parsed into the AST, but a
diagnostics::ParseError::VersionTooLow diagnostic is emitted.
use php_rs_parser::{ParseOptions, PhpVersion};
let result = php_rs_parser::parse_with(
"<?php enum Status { case Active; }",
&ParseOptions::default().version(PhpVersion::Php80),
);
assert!(!result.errors.is_empty()); // enums require PHP 8.1
Multi-file cache
parse returns a ParseResult with no lifetime parameters — fully
owned, storable in a HashMap, sendable across threads.
use std::collections::HashMap;
use std::path::PathBuf;
let mut cache: HashMap<PathBuf, php_rs_parser::ParseResult> = HashMap::new();
cache.insert(PathBuf::from("a.php"), php_rs_parser::parse("<?php echo 1;"));
Arena API (LSP / hot-path usage)
Use parse_arena / ParserContext when you need maximum throughput
and can manage the arena lifetime yourself. The returned
ArenaParseResult borrows from both the arena and the source string —
no allocation copying occurs.
let mut ctx = php_rs_parser::ParserContext::new();
let result = ctx.reparse("<?php echo 1;");
assert!(result.errors.is_empty());
drop(result); // must be dropped before the next reparse
let result = ctx.reparse("<?php echo 2;");
assert!(result.errors.is_empty());
Set ParseOptions::source_map to false when you never need
line/column positions — it skips building the source_map::SourceMap
and is slightly faster.
Dependencies
~0.6–1.3MB
~27K SLoC