Update README.md

This commit is contained in:
BSKY
2020-02-12 14:37:36 +09:00
parent 292748a084
commit 1634da56c2

View File

@@ -8,31 +8,32 @@
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)
[![License](https://img.shields.io/github/license/asdf-community/asdf-php?style=flat-square&color=brightgreen)](https://github.com/asdf-community/asdf-php/blob/master/LICENSE)
_Original version of this plugin created by [@Stratus3D](https://github.com/Stratus3D)_
_Original version of this plugin created by
[@Stratus3D](https://github.com/Stratus3D)_
## Note: PHP-PEAR
PHP Pear is down without ETA for when the server will be back. To install PHP without Pear you can specify a `PHP_WITHOUT_PEAR` variable with any value (except no), eg:
PHP Pear is down without ETA for when the server will be back. To install PHP
without Pear you can specify a `PHP_WITHOUT_PEAR` variable with any value
(except no), eg:
```
PHP_WITHOUT_PEAR=yes asdf install php 7.2.14
```
## Why use this plug-in?
## Installation
[Original plug-in](https://github.com/Stratus3D/asdf-php) appears to be unmaintained and it doesn't work anymore (at least on macOS), so I fixed it to provide compatibility and improve its documentation.
## Install
```
```bash
asdf plugin-add php https://github.com/asdf-community/asdf-php.git
```
**Please, remember installing the commonly required libraries that can be found on the `asdf` README. They are necessary to build PHP versions too!**
**Please, remember installing the commonly required libraries that can be found
on the `asdf` README. They are necessary to build PHP versions too!**
### Linux
You may need this libraries and packages to be able to compile PHP compiler versions:
You may need this libraries and packages to be able to compile PHP compiler
versions:
```
sudo apt-get install curl build-essential autoconf libjpeg-dev libpng12-dev openssl libssl-dev libcurl4-openssl-dev pkg-config libsslcommon2-dev libreadline-dev libedit-dev zlib1g-dev libicu-dev libxml2-dev gettext bison libmysqlclient-dev libpq-dev libsqlite3-dev libonig-dev
@@ -52,7 +53,8 @@ To compile PHP on macOS machines, you must install some brew packages first:
brew install freetype bison bison27 gettext icu4c jpeg libiconv libpng openssl readline zlib
```
Use environment variables to instruct autoconf on where to find the libraries you installed using homebrew. Note that:
Use environment variables to instruct `autoconf` on where to find the libraries
you installed using homebrew. Note that:
- for PHP 5.6, you must use `brew --prefix bison@2.7` in your PATH
- for PHP 7.x, you must use `brew --prefix bison` in your PATH
@@ -63,7 +65,11 @@ So replace if necessary:
PATH="$(brew --prefix bison)/bin:$(brew --prefix icu4c)/bin:$(brew --prefix icu4c)/sbin:$PATH" PHP_CONFIGURE_OPTIONS="--with-iconv=$(brew --prefix libiconv) --with-openssl=$(brew --prefix openssl)" asdf install php <version>
```
**Important note**: There seems to be a bug with PHP `configure` file on recent versions (> 7.1.4) when using macOS environments. As can be seen in [this PR](https://github.com/phpbrew/phpbrew/issues/876#issuecomment-301553990), it's needed to disable gettext at build time to work, and later on, impact the module manually.
**Important note**: There seems to be a bug with PHP `configure` file on recent
versions (> 7.1.4) when using macOS environments. As can be seen in
[this PR](https://github.com/phpbrew/phpbrew/issues/876#issuecomment-301553990),
it's needed to disable `gettext` at build time to work, and later on, impact the
module manually.
To disable it, just execute this **before** run the `asdf install` command:
@@ -73,27 +79,17 @@ $ export PHP_CONFIGURE_OPTIONS='--disable-gettext'
## Development
To modify this plugin into your `asdf` installation and see changes live, just create a symlink:
To modify this plugin into your `asdf` installation and see changes live, just
create a symlink:
```
ln -s . ~/.asdf/plugins/php
```
## Use
## Usage
Check the [asdf](https://github.com/HashNuke/asdf) readme for instructions on how to install & manage versions of PHP.
## Contributing
Feel free to create an issue or pull request if you find a bug.
Note that the Travis builds for your PR _will_ fail: https://github.com/asdf-community/asdf-php/pull/4#issuecomment-319123603
## Issues
### No available versions shown
This could be due to GitHub API quota limits. To solve it, you just need to specify `GITHUB_API_USER` and `GITHUB_API_KEY` with your username and a [Personal Access Token](https://github.com/settings/tokens), so the `list-all` command can use it to fetch available versions.
Check [asdf](https://github.com/asdf-vm/asdf) readme for instructions on how to
install & manage versions.
## License