5 releases

0.1.0 Jan 6, 2023
0.0.0 Nov 28, 2022
0.0.0-b4 Jan 6, 2023
0.0.0-b3 Dec 20, 2022
0.0.0-b2 Dec 13, 2022

#306 in Parser implementations

23 downloads per month

MIT/Apache

505KB
12K SLoC

PHP-Parser

A handwritten fault-tolerant, recursive-descent parser for PHP written in Rust.

justforfunnoreally.dev badge

Warning: This crate is not ready for any form of production use yet. There are still a lot of things missing from the parser, so please use at your own risk.


Usage

Add php-parser-rs in your Cargo.toml's dependencies section

[dependencies]
php-parser-rs = { git = "https://github.com/php-rust-tools/parser" }

or use cargo add

cargo add php-parser-rs --git https://github.com/php-rust-tools/parser

Example

use std::io::Result;

use php_parser_rs::parser;

const CODE: &str = r#"<?php

final class User {
    public function __construct(
        public readonly string $name,
        public readonly string $email,
        public readonly string $password,
    ) {
    }
}
"#;

fn main() -> Result<()> {
    match parser::parse(CODE) {
        Ok(ast) => {
            println!("{:#?}", ast);
        }
        Err(err) => {
            println!("{}", err.report(CODE, None, true, false)?);

            println!("parsed so far: {:#?}", err.partial);
        }
    }

    Ok(())
}

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Credits

Dependencies

~3.5MB
~66K SLoC