add docs for crazywhalecc/static-php-cli#421

Author: crazywhalecc

docs/en/faq/index.md

@@ -60,3 +60,15 @@ The phpmicro referenced by this project and related projects is only a package o
 The compiler for PHP code is a completely different project, so the extra cases are not taken into account. 
 If you are interested in encryption, you can consider using existing encryption technologies, 
 such as Swoole Compiler, Source Guardian, etc.
+
+## Unable to use ssl
+
+When using curl, pgsql, etc. to request an HTTPS website or establish an SSL connection, there may be an `error:80000002:system library::No such file or directory` error.
+This error is caused by statically compiled PHP without specifying `openssl.cafile` via `php.ini`.
+
+You can solve this problem by specifying `php.ini` before using PHP and adding `openssl.cafile=/path/to/your-cert.pem` in the INI.
+
+For Linux systems, you can download the [cacert.pem](https://curl.se/docs/caextract.html) file from the curl official website, or you can use the certificate file that comes with the system.
+For the certificate locations of different distros, please refer to [Golang docs](https://go.dev/src/crypto/x509/root_linux.go).
+
+> INI configuration `openssl.cafile` cannot be set dynamically using the `ini_set()` function, because `openssl.cafile` is a `PHP_INI_SYSTEM` type configuration and can only be set in the `php.ini` file.

docs/en/guide/extension-notes.md

@@ -4,6 +4,11 @@ Because it is a static compilation, extensions will not compile 100% perfectly,
 and different extensions have different requirements for PHP and the environment, 
 which will be listed one by one here.
 
+## curl
+
+When using curl to request HTTPS, there may be an `error:80000002:system library::No such file or directory` error.
+For details on the solution, see [FAQ - Unable to use ssl](../faq/#unable-to-use-ssl).
+
 ## phpmicro
 
 1. Only PHP >= 8.0 is supported.
@@ -100,12 +105,21 @@ The compiled `./php` binary can be configured and run by specifying the INI, eg
 
 ~~pgsql ssl connection is not compatible with openssl 3.2.0. See:~~
 
-- ~~https://github.com/Homebrew/homebrew-core/issues/155651~~
-- ~~https://github.com/Homebrew/homebrew-core/pull/155699~~
-- ~~https://github.com/postgres/postgres/commit/c82207a548db47623a2bfa2447babdaa630302b9~~
+- ~~<https://github.com/Homebrew/homebrew-core/issues/155651>~~
+- ~~<https://github.com/Homebrew/homebrew-core/pull/155699>~~
+- ~~<https://github.com/postgres/postgres/commit/c82207a548db47623a2bfa2447babdaa630302b9>~~
 
 pgsql 16.2 has fixed this bug, now it's working.
 
+When pgsql uses SSL connection, there may be `error:80000002:system library::No such file or directory` error,
+For details on the solution, see [FAQ - Unable to use ssl](../faq/#unable-to-use-ssl).
+
+## openssl
+
+When using openssl-based extensions (such as curl, pgsql and other network libraries),
+there may be an `error:80000002:system library::No such file or directory` error.
+For details on the solution, see [FAQ - Unable to use ssl](../faq/#unable-to-use-ssl).
+
 ## password-argon2
 
 1. password-argon2 is not a standard extension, it is an additional algorithm for the `password_hash` function.

docs/extensions.md

@@ -5,7 +5,7 @@
 | bz2                                                        | yes           | yes            | yes           |               |
 | calendar                                                   | yes           | yes            | yes           | yes           |
 | ctype                                                      | yes           | yes            | yes           | yes           |
-| curl                                                       | yes           | yes            | yes           | yes           |
+| [curl](./extension-notes#curl)                             | yes           | yes            | yes           | yes           |
 | dba                                                        | yes           | yes            | yes           | yes           | 
 | dom                                                        | yes           | yes            |               | yes           |
 | ds                                                         | yes, untested | yes, untested  | yes, untested | yes, untested |
@@ -37,7 +37,7 @@
 | mysqlnd                                                    | yes           | yes            | yes           | yes           |
 | [oci8](./extension-notes#oci8)                             | no            | no             | no            |               |
 | opcache                                                    | yes           | yes            | yes           | yes           |
-| openssl                                                    | yes           | yes            | yes           | yes           |
+| [openssl](./extension-notes#openssl)                       | yes           | yes            | yes           | yes           |
 | [password-argon2](./extension-notes#password-argon2)       | yes           | yes            |               |               |
 | pcntl                                                      | yes           | yes            | yes           | no            |
 | pdo                                                        | yes           | yes            | yes           | yes           |

docs/zh/faq/index.md

@@ -47,3 +47,15 @@ bin/spc build ffi --build-cli --no-strip
 所以本项目（static-php-cli）、相关项目（lwmbs、swoole-cli）都是提供一个对 php-src 源码的便捷编译工具，
 本项目和相关项目引用的 phpmicro 也仅仅是 PHP 的 sapi 接口封装，而不是 PHP 代码的编译工具。
 PHP 代码的编译器是完全不同的项目，因此不会考虑额外的情况。如果你对加密感兴趣，可以考虑使用现有的加密技术，如 Swoole Compiler、Source Guardian 等。
+
+## 无法使用 ssl
+
+使用 curl、pgsql 等 请求 HTTPS 网站或建立 SSL 连接时，可能存在 `error:80000002:system library::No such file or directory` 错误，
+这个错误是由于静态编译的 PHP 未通过 `php.ini` 指定 `openssl.cafile` 导致的。
+
+你可以在使用 PHP 前指定 `php.ini`，并在 INI 内添加 `openssl.cafile=/path/to/your-cert.pem` 来解决这个问题。
+
+对于 Linux 系统，你可以从 curl 官方网站下载 [cacert.pem](https://curl.se/docs/caextract.html) 文件，也可以使用系统自带的证书文件。
+有关不同发行版的证书位置，可参考 [Go 标准库](https://go.dev/src/crypto/x509/root_linux.go)。
+
+> INI 配置 `openssl.cafile` 不可以使用 `ini_set()` 函数动态设置，因为 `openssl.cafile` 是一个 `PHP_INI_SYSTEM` 类型的配置，只能在 `php.ini` 文件中设置。

docs/zh/guide/extension-notes.md

@@ -2,6 +2,11 @@
 
 因为是静态编译，扩展不会 100% 完美编译，而且不同扩展对 PHP、环境都有不同的要求，这里将一一列举。
 
+## curl
+
+使用 curl 请求 HTTPS 时，可能存在 `error:80000002:system library::No such file or directory` 错误，
+解决办法详见 [FAQ - 无法使用 ssl](../faq/#无法使用-ssl)。
+
 ## phpmicro
 
 1. phpmicro SAPI 仅支持 PHP >= 8.0 版本。
@@ -91,12 +96,20 @@ bin/spc build gd --with-libs=freetype,libjpeg,libavif,libwebp --build-cli
 
 ~~pgsql ssl 连接与 openssl 3.2.0 不兼容。相关链接：~~
 
-- ~~https://github.com/Homebrew/homebrew-core/issues/155651~~
-- ~~https://github.com/Homebrew/homebrew-core/pull/155699~~
-- ~~https://github.com/postgres/postgres/commit/c82207a548db47623a2bfa2447babdaa630302b9~~
+- ~~<https://github.com/Homebrew/homebrew-core/issues/155651>~~
+- ~~<https://github.com/Homebrew/homebrew-core/pull/155699>~~
+- ~~<https://github.com/postgres/postgres/commit/c82207a548db47623a2bfa2447babdaa630302b9>~~
 
 pgsql 16.2 修复了这个 Bug，现在正常工作了。
 
+在 pgsql 使用 SSL 连接时，可能存在 `error:80000002:system library::No such file or directory` 错误，
+解决办法详见 [FAQ - 无法使用 ssl](../faq/#无法使用-ssl)。
+
+## openssl
+
+使用基于 openssl 的扩展（如 curl、pgsql 等网络库）时，可能存在 `error:80000002:system library::No such file or directory` 错误，
+解决办法详见 [FAQ - 无法使用 ssl](../faq/#无法使用-ssl)。
+
 ## password-argon2
 
 1. password-argon2不是一个标准的扩展，它是 `password_hash` 函数的额外算法。