NPM 包 phpegjs 使用教程

面试官:小伙子,你的代码为什么这么丝滑?

介绍

phpegjs 是一个基于 JavaScript 实现的解析器生成器,它可以用于生成 PHP 语言的解析器。该工具支持语法输入文件的自定义,让用户可以灵活地根据需求定制自己的解析器。

安装

phpegjs 可以通过 NPM 包管理器进行安装,使用以下命令进行安装:

--- ------- -- -------

基础使用

在使用 phpegjs 之前,需要准备好使用的语法输入文件。这里以一个简单的四则运算语法文件(calc.pegjs)为例:

----------
  - --------

--------
  - ------------------- --- --------------
  - --------------

--------------
  - ---------- --- --------------------
  - -----

-----
  - --- ----------
  - -------

-------
  - -------------
  - --- ---------- --- - ------ -- -

其中,Expression 是该语法文件的起始符号。Addition 表示加法运算,Multiplication 表示乘法运算,Unary 表示负号运算,Primary 表示数字或括号表达式。

在命令行中运行以下命令即可生成对应的 PHP 解析器文件:

------- ---------- --------

生成的 PHP 解析器文件中,会包含与输入语法文件对应的各个解析规则的实现。以 calc.pegjs 的例子为参考,生成的 calc.php 文件中包含了如下内容:

-----

---------------- - -----------
------------------- - --------
------------------- - -------
-------------------- - -------
------------- - -------
-------------- - ------
-------------- - -------
--------------- - --------
--------------- - ------
----------------- - -------

-------- --------------- -
  ------- - ---
  ------- ------- -- ------ -
    -- ----------------- -
      ------- ------ -- --------- -
        --------- - ---------
      -
    - ---- -
      --------- - ------
    -
  -
  ------ --------
-

-------- -------------------- ---- ------- ------- -
  ----------------
  ------ -------- -
  ---- ----------
    ------ ------- -- ---
  ---- -----------
    ------ ----- - -------
  ---- -----------------
    ------ ----- - -------
  ---- --------
    ------ ------------------------------
  ---- -------------
    ------ ----------
  --------
    ----- --- ------------------ ------ ----- ---------
  -
-

----- ---------- -
  -------- ------------------- -------- - --- -
    -------------- - --- --------------------
    -------------- - ---
    --------------- - --
    -------------------- - -----
    ------------ - -----

    -- ---------------------------- -
      -------------- - --------------------
    - ---- -
      -------------- - ---
    -
  -

  -------- -------- -
    ------ -------------------------
  -

  -------- ----- -
    ------ ----------------------
  -

  -------- ----------- -
    ------ ----------------------------
  -

  -------- ---------- -
    ------ ---------------------------
  -

  -------- ------------ - ------------- -
    ------ - ---------- -- -------
    ----- ------ -
      ------ - ---------------------------
      -- --------------- --- ----------------------- -
        ------
      -
      ---- - ---------------
      -- ------------------------------ -
        -- -------------------------- ----- -------- -
          -------------------- - ------------ -------- ----- - ------ ---------- -----
        - ------ ------------------------- ----- -------- -
          -- --------------------------- ----------- -
            -------------------- - ------------ -------- ----- - ------ -------------- -----
          - ---- -
            -------------------- - ------------ -------- ----- - ------ ----------------- -----
          -
        - ---- -
          -------------------- - ------------ -------- ----- - ------ ---- -----
        -
      -
    -
    ------ --------------------- --------
  -

  -------- -------------- ------- -
    ------- - -----------
    ----- - ----------------
    --------- - ------------------------------ - --------------------------------- - ---
    --- - --
    ------ - ---------- ---------
    ----- -------------- - -- -
      ------------ ------ - -------------------- - ---
      -- ---- -- --------------------- -
        ------------------
        ---------
      -
      ------ - ---------------------------
      ----- - -------------------
      -- ------------------ -
        -- ------ -- --------------- -
          --------------- - ------------- - ------------------------
          ------
        - ---- -
          ------- - ---------------------
          -- ------------------------------- -
            ---------------------
            ----------- - ------------------------------
            --------------- - ------
            --- - ---------------------
            ---------
          - ---- -
            ------------ - -
              ------ -- --------------
              --------- -- --------- ----- --- ---------------- --------
              ----- -- ---------------
            --
            ------ -----
          -
        -
      - ---- -
        ------ - ------
        ---------------------
        --- --- - ------------ - -- -- -- -- ----- -
          ---- - ----------
          -- ---------------------- -
            ------------ - ---
          -
          ------------------------ --------------------------
          ------------------------ -
            --------------------------------------------
            ---------- -- -------
          ---
        -
        ------------------
        ------------------ -------- --------
        ------- --------------------- -- ----- -
          ------------------ ----------------------------- ---------
        -
        ----------- - -----
        --- - --
      -
      -- ---- -- --------------------- -
        ------------------
        -- ------------------------------- -
          ----- - ------------------- ---- -- ------------
          ---------------------
          ----------- - ------------------------------
        -
      -
    -
    ------ -------------
  -
-

----- ----------- -
  ----- --------- - --

  -------- ------------------- -
    ------------ - -------
    ---------- - --
    -------------------
  -

  -------- -------- -
    ------ -----------
  -

  -------- ----------- -
    ----- ----------- - --------------------- -
      -- ---------------------------------------- ------------- ------- ----- ------------ -
        ---------- -- ------------------
        ------------ - -
          ------ -- ---------
          ------- -- ----------
          ----- -- ---------- - ------------------
        --
        -------
      - ------ ------------------------------------------- ------------- ------- ----- ------------ -
        ---------- -- ------------------
        ---------
      - ------ ------------------------------------- ------------- ------- ----- ------------ -
        ---------- -- ------------------
        ------------ - -
          ------ -- ----
          ------- -- ----------
          ----- -- ---------- - ------------------
        --
        -------
      - ------ -------------------------------------- ------------- ------- ----- ------------ -
        ---------- -- ------------------
        ------------ - -
          ------ -- ----
          ------- -- ----------
          ----- -- ---------- - ------------------
        --
        -------
      - ------ -------------------------------------- ------------- ------- ----- ------------ -
        ---------- -- ------------------
        ------------ - -
          ------ -- ----
          ------- -- ----------
          ----- -- ---------- - ------------------
        --
        -------
      - ------ --------------------------------------- ------------- ------- ----- ------------ -
        ---------- -- ------------------
        ------------ - -
          ------ -- ----
          ------- -- ----------
          ----- -- ---------- - ------------------
        --
        -------
      - ------ --------------------------------------- ------------- ------- ----- ------------ -
        ---------- -- ------------------
        ------------ - -
          ------ -- ----
          ------- -- ----------
          ----- -- ---------- - ------------------
        --
        -------
      - ------ ----------------------------------------- ------------- ------- ----- ------------ -
        ---------- -- ------------------
        ------------ - -
          ------ -- ----
          ------- -- ----------
          ----- -- ---------- - ------------------
        --
        -------
      - ------ ------------------------------------------- ------------- ------- ----- ------------ -
        ---------- -- ------------------
        ------------ - -
          ------ -- ----
          ------- -- ----------
          ----- -- ---------- - ------------------
        --
        -------
      - ------ -------------------------------------------- ------------- ------- ----- ------------ -
        ---------- -- ------------------
        ------------ - -
          ------ -- ----
          ------- -- ----------
          ----- -- ---------- - ------------------
        --
        -------
      - ---- -
        -------------
        ---------
      -
    -
    ------------ - -
      ------ -- ----------------
      ------- -- ---
      ----- -- -----------
    --
  -

  -------- ---------- -
    ------ -------------
  -

  -------- ----- -
    ------ -------------------- --- ----------------
  -
-

在 PHP 代码中使用该解析器可以通过以下方式实现:

------- - --- ------------- - - - -- - -----
------- - -----------------
---- -------- -- --

进阶用法

phpegjs 支持对语法输入文件进行自定义,通过自定义语法输入文件,可以让生成的解析器具有更高的灵活性。以 calc.pegjs 的例子为参考,以下是该语法文件的注释信息,可以帮助我们更深入地了解 phpegjs 的用法:

-- ------- ------ --
-- ---------- --
----------
  - --------

--------
  - ------------------- --- --------------
  - --------------

--------------
  - ---------- --- --------------------
  - -----

----- -- ---- --
  - --- ----------
  - -------

------- -- ----- --
  - -------------
  - --- ---------- --- - ------ -- - -- -------------- --

-- -------- ------ ---- ----- --
-- --------- --
--------- ------ - ------ - ----- ------ ----- ----- ------ ----- -- -
-------------- ------ - ------ - ----- ----------- ----- ----- ------ ----- -- -
------------- - ------ - ----- --------- ------ ----- -- -
------------- - ------ - ----- --------- ------ ----- -- -

-- ---------- --
-- -------- --
-
  --- - - --------------- - ------- ------------ - - --
  --- - - --------------- - ------- ------------ - - --
  --- - - --------------- - ------- ------------ - - --
  --- - - --------------- - ------- ------------ - - -
-

除了定义词法分析器的模式(即正则表达式)和语法规则之外,calc.pegjs 中还定义了输出解析器对应的抽象语法树节点和运算符优先级等信息,这些信息可以方便我们更好地控制解析器的行为。

我们可以自定义 calc.pegjs,让生成的 PHP 解析器实现更高级的功能。作为示例,以一个简单的日期格式解析器为例:

----
  - --------- --- ----------- --- ------- - ------ - ----- --------------- ------ ---------------- ---- ------------- -- -

----
  - --------

-----
  - ----------------- - ------ ---------------- -

---
  - ----------------- - ------ ---------------- -

运行以下命令即可生成对应的日期格式解析器:

------- ---------- --------

在 PHP 代码中使用该解析器可以通过以下方式实现:

------- - --- -------------------------
------- - -----------------
------------------ -- ------------ -- ----- ------- -- --- ----- -- ---

总结

phpegjs 是一个强大的解析器生成器,可以帮助我们生成各种语言的解析器。在使用过程中,我们需要先准备好用于生成解析器的语法输入文件,并通过 NPM 包管理器进行安装。通过定义语法规则、抽象语法树节点和优先级等信息,我们可以方便地控制生成的解析器的行为。通过本教程的介绍,相信你已经掌握了 phpegjs 的基础用法和进阶技巧,可以使用该工具生成自己需要的解析器。

来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/60055d2d81e8991b448dae5d


猜你喜欢

  • Fastify 入门:安装和使用指南

    Fastify 是 Node.js 上一个快速且低延迟的 Web 框架,主要用于构建高效的 Restful API。与其他 Node.js 框架相比,Fastify 的性能更加强大,支持异步编程,具有...

    1 天前
  • 怎样在 Ubuntu 系统中安装 PM2

    PM2是一款开源的Node.js进程管理器,可以帮助我们更方便的管理我们的Node.js应用程序,减少Node.js应用程序宕机的可能性。本文将详细介绍如何在Ubuntu系统上安装PM2,并提供相关示...

    1 天前
  • React 测试工具 Enzyme:一个入门指南

    在前端开发中,我们经常需要对 React 组件进行测试来确保其行为与预期一致。而 Enzyme 就是一款广受欢迎的 React 测试工具,它提供了强大的 API 来帮助我们进行组件测试。

    1 天前
  • 解析 ES12 引入的数字分隔符

    随着 JavaScript 语言的不断发展,ES12 (即 ECMAScript 2021)引入了新的语法:数字分隔符。这个新的语法允许使用下划线(_)来分隔数字,使得数字更加易读和易于理解。

    1 天前
  • 如何在 PWA 中添加自定义的缓存策略?

    随着移动设备的普及和网络技术的不断进步,越来越多的应用程序开始采用 Progressive Web App(PWA)技术。PWA可以将网站应用程序转化为离线可访问、快速响应和具有本地化功能的应用程序,...

    1 天前
  • 如何使用 Babel 将代码转换成 ES2015

    在前端开发中,越来越多的开发者开始将目光投向了新一代的 JavaScript 语言规范 ES2015(也叫作 ECMAScript 6)。ES2015 引入了许多新特性和语言功能,可以让我们写出更加简...

    1 天前
  • Express.js 实现登陆验证教程

    随着互联网的发展,越来越多的网站和应用需要实现用户注册和登录功能。这些功能对于网站和应用的安全性和用户体验至关重要。本文将介绍如何使用 Express.js 实现登陆验证功能,让你的网站和应用更加安全...

    1 天前
  • Redux 中如何使用中间件?

    什么是 Redux 中间件? Redux 中间件是 Redux 应用程序中的可插入功能,它允许在派发和处理 Redux Action 之间添加其他操作和逻辑。中间件可以处理异步操作、调用 API,添加...

    1 天前
  • 使用 Jest 测试插件——vue-test-utils

    Vue.js 是一个流行的前端 JavaScript 框架,可以帮助我们构建交互式的 web 应用程序。在开发过程中,测试是一个重要的步骤,有助于确保我们的代码在不同情况下的正确性。

    1 天前
  • Sequelize 够用吗?ORM 到底是不是好东西?

    随着前端技术的不断发展,越来越多的开发者开始使用 ORM(对象关系映射)框架来管理数据库。其中,Sequelize 是一个广泛使用的 ORM 框架之一,它可以让你使用 JavaScript 来操作数据...

    1 天前
  • PostgreSQL 10 的新功能和性能优化

    PostgreSQL 是一款功能强大、可扩展性好的关系型数据库,被广泛地用于各种 web 应用和企业应用中。在最新的 PostgreSQL 10 版本中,新增了一些重要的新功能和性能优化,本文将详细介...

    1 天前
  • 如何使用 Socket.io 和 MongoDB 实现聊天室?

    前端技术的发展让实时聊天变得越来越普遍,我们可以通过使用 Socket.io 和 MongoDB 实现一个简单的实时聊天室。在本文中,我们将介绍如何使用这两个技术来实现聊天室。

    1 天前
  • 详解:Dockerfile 中 ADD 与 COPY 的区别

    详解:Dockerfile 中 ADD 与 COPY 的区别 在 Dockerfile 文件中,ADD 和 COPY 都是用于将文件从本地复制到 Docker 镜像中。然而,它们有着不同的用法和作用。

    1 天前
  • Kubernetes 中 RBAC 实现权限控制的方法及注意事项

    在 Kubernetes 中,RBAC 是一种用于授权用户访问 API 资源的方法。通过 RBAC,用户可以设置不同的访问权限,以便于控制 Kubernetes 集群中各种资源的访问情况。

    1 天前
  • 解决 CSS Flexbox 实现横向滚动条的问题

    在开发 Web 应用时,经常需要在页面中实现横向滚动条,使得页面内容能够轮廓展示。实现过程中,CSS Flexbox 布局经常被使用。然而,在使用 Flexbox 实现横向滚动条时,往往会遇到一些问题...

    1 天前
  • 常见错误解决方案 - Express.js 使用

    Express.js 是 Node.js 最流行的 Web 应用程序框架,它提供了简单而强大的 API 来构建 Web 应用。然而,即使是最流行的框架也只是一种工具,使用不当或者疏忽都容易出现问题。

    1 天前
  • Cypress 自动化测试实战:端到端测试篇

    Cypress 是一个现代化的端到端测试工具,它是专门为现代 Web 应用程序打造的。Cypress 拥有丰富的 API,易于使用和学习,同时提供了一个交互式的测试运行器和强大的调试工具。

    1 天前
  • 如何使用 ES11 中的 Promise.allSettled 方法实现批量异步请求

    如何使用 ES11 中的 Promise.allSettled 方法实现批量异步请求 在前端开发中,经常需要发送多个异步请求,这时候我们可以使用 Promise.all 方法来处理,但是如果其中一个请...

    1 天前
  • Next.js HMR 原理解析

    在前端开发中,HMR(热模块替换)已经成为了一个常见的开发技术,可以大大提高开发效率和代码质量。Next.js 是一个流行的 React 服务端渲染框架,它也提供了 HMR 的支持。

    1 天前
  • Redux 中如何处理持久化数据?

    Redux 是一个流行的 JavaScript 应用程序状态管理库,但是我们如何在 Redux 中处理持久化数据?在本文中,我们将探讨一些在 Redux 中处理持久化数据的方法,并提供一些示例代码和最...

    1 天前