static-php-cli/docs/en/guide/troubleshooting.md

# Troubleshooting

Various failures may be encountered in the process of using static-php-cli, 
here will describe how to check the errors by yourself and report Issue.

## Download Failure

Problems with downloading resources are one of the most common problems with spc. 
The main reason is that the addresses used for SPC download resources are generally the official website of the corresponding project or GitHub, etc.,
and these websites may occasionally go down and block IP addresses.
After encountering a download failure, 
you can try to call the download command multiple times. 

When downloading extensions, you may eventually see errors like `curl: (56) The requested URL returned error: 403` which are often caused by github rate limiting.
You can verify this by adding `--debug` to the command and will see something like `[DEBU] Running command (no output) : curl -sfSL   "https://api.github.com/repos/openssl/openssl/releases"`.

To fix this, [create](https://github.com/settings/tokens) a personal access token on GitHub and set it as an environment variable `GITHUB_TOKEN=<XXX>`.

If you confirm that the address is indeed inaccessible, 
you can submit an Issue or PR to update the url or download type.

## Doctor Can't Fix Something

In most cases, the doctor module can automatically repair and install missing system environments, 
but there are also special circumstances where the automatic repair function cannot be used normally.

Due to system limitations (for example, software such as Visual Studio cannot be automatically installed under Windows),
the automatic repair function cannot be used for some projects.
When encountering a function that cannot be automatically repaired, 
if you encounter the words `Some check items can not be fixed`,
it means that it cannot be automatically repaired.
Please submit an issue according to the method displayed on the terminal or repair the environment yourself.

## Compile Error

When you encounter a compilation error, if the `--debug` log is not enabled, please enable the debug log first,
and then determine the command that reported the error.
The error terminal output is very important for fixing compilation errors.
When submitting an issue, please upload the last error fragment of the terminal log (or the entire terminal log output),
and include the `spc` command and parameters used.
Merge docs into static-php-cli repo (#492) * Move docs to here * Move docs to here * Modify old docs links 2024-07-01 10:29:31 +08:00			`# Troubleshooting`

			`Various failures may be encountered in the process of using static-php-cli,`
			`here will describe how to check the errors by yourself and report Issue.`

			`## Download Failure`

			`Problems with downloading resources are one of the most common problems with spc.`
			`The main reason is that the addresses used for SPC download resources are generally the official website of the corresponding project or GitHub, etc.,`
			`and these websites may occasionally go down and block IP addresses.`
add opentelemetry extension support (#593) * add opentelemetry extension support * config sort * cleanup build args * Update docs * Adjust custom extension overrides for opentelemetry * Add tests * Update README.md and remove windows limitation * Fix windows static build for opentelemetry --------- Co-authored-by: crazywhalecc <jesse2061@outlook.com> 2025-02-06 05:27:43 +01:00			`After encountering a download failure,`
			`you can try to call the download command multiple times.`

			When downloading extensions, you may eventually see errors like `curl: (56) The requested URL returned error: 403` which are often caused by github rate limiting.
			You can verify this by adding `--debug` to the command and will see something like `[DEBU] Running command (no output) : curl -sfSL "https://api.github.com/repos/openssl/openssl/releases"`.

			To fix this, [create](https://github.com/settings/tokens) a personal access token on GitHub and set it as an environment variable `GITHUB_TOKEN=<XXX>`.

			`If you confirm that the address is indeed inaccessible,`
Merge docs into static-php-cli repo (#492) * Move docs to here * Move docs to here * Modify old docs links 2024-07-01 10:29:31 +08:00			`you can submit an Issue or PR to update the url or download type.`

			`## Doctor Can't Fix Something`

			`In most cases, the doctor module can automatically repair and install missing system environments,`
			`but there are also special circumstances where the automatic repair function cannot be used normally.`

			`Due to system limitations (for example, software such as Visual Studio cannot be automatically installed under Windows),`
			`the automatic repair function cannot be used for some projects.`
			`When encountering a function that cannot be automatically repaired,`
			if you encounter the words `Some check items can not be fixed`,
			`it means that it cannot be automatically repaired.`
			`Please submit an issue according to the method displayed on the terminal or repair the environment yourself.`

			`## Compile Error`

			When you encounter a compilation error, if the `--debug` log is not enabled, please enable the debug log first,
			`and then determine the command that reported the error.`
			`The error terminal output is very important for fixing compilation errors.`
			`When submitting an issue, please upload the last error fragment of the terminal log (or the entire terminal log output),`
			and include the `spc` command and parameters used.