mirror of
https://github.com/crazywhalecc/static-php-cli.git
synced 2026-03-18 04:44:53 +08:00
43 lines
2.4 KiB
Markdown
43 lines
2.4 KiB
Markdown
# 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.
|
|
|
|
If you are rebuilding, please refer to the [Local Build - Multiple Builds](./manual-build#multiple-builds) section.
|