]> git.kaiwu.me - njs.git/commitdiff
Updated README with QuickJS module build instructions.
authorDmitry Volyntsev <xeioex@nginx.com>
Wed, 23 Oct 2024 01:10:25 +0000 (18:10 -0700)
committerDmitry Volyntsev <xeioexception@gmail.com>
Wed, 23 Oct 2024 05:18:47 +0000 (22:18 -0700)
README.md

index 5beac3c0223710b7ff4c19532d0169c53bf474f4..855d9c0b738061eaad16be65d7cb854b9687a748 100644 (file)
--- a/README.md
+++ b/README.md
@@ -258,6 +258,12 @@ sudo apt install gcc make
 sudo apt install libpcre3-dev zlib1g-dev libssl-dev libxml2-dev libxslt-dev
 ```
 
+For building with [QuickJS](https://nginx.org/en/docs/njs/engine.html), you will also need to clone the QuickJS repository:
+
+```bash
+git clone https://github.com/bellard/quickjs
+```
+
 > [!WARNING]
 > This is the minimal set of dependency libraries needed to build NGINX and NJS. Other dependencies may be required if you choose to build NGINX with additional modules. Monitor the output of the `configure` command discussed in the following sections for information on which modules may be missing.
 
@@ -306,6 +312,12 @@ To build NGINX JavaScript as a dynamic module, execute the following commands fr
 auto/configure --add-dynamic-module=<NJS_SRC_ROOT_DIR>/nginx
 ```
 
+To build with [QuickJS](https://nginx.org/en/docs/njs/engine.html) support, provide include and library path using `--with-cc-opt=` and `--with-ld-opt=` options:
+```bash
+auto/configure --add-dynamic-module=<NJS_SRC_ROOT_DIR>/nginx \
+    --with-cc-opt="-I<QUICKJS_SRC_ROOT_DIR>" --with-ld-opt="-L<QUICKJS_SRC_ROOT_DIR>"
+```
+
 > [!WARNING]
 > By default, this method will only build the `ngx_http_js_module` module. To use NJS with the NGINX Stream module, you'll need to enable it during the `configure` step so it builds with the NGINX binary. Doing so will automatically compile the `ngx_stream_js_module` module when NJS is added to the build. One way of accomplishing this is to alter the `configure` step to:
 > ```bash