Skip to content

Commit 5043535

Browse files
committed
Import some Docker Hub formatting for easier merges
Ref: docker-library/docs#2527
1 parent 22f2d4a commit 5043535

File tree

1 file changed

+65
-65
lines changed

1 file changed

+65
-65
lines changed

README.md

Lines changed: 65 additions & 65 deletions
Original file line numberDiff line numberDiff line change
@@ -30,29 +30,29 @@ database server image for information on the default username and password or ho
3030

3131
The official MySQL and MariaDB images use the following environment variables to define these:
3232

33-
* `MYSQL_ROOT_PASSWORD` - This variable is mandatory and specifies the password that will be set for the `root` superuser account.
34-
* `MYSQL_USER`, `MYSQL_PASSWORD` - These variables are optional, used in conjunction to create a new user and to set that user's password.
33+
- `MYSQL_ROOT_PASSWORD` - This variable is mandatory and specifies the password that will be set for the `root` superuser account.
34+
- `MYSQL_USER`, `MYSQL_PASSWORD` - These variables are optional, used in conjunction to create a new user and to set that user's password.
3535

3636
## Supported Docker Hub tags
3737

3838
The following tags are available:
3939

40-
* `latest`, `fpm`, and `fpm-alpine` are always the most recent released version
41-
* Major versions, such as `5`, `5-fpm`, and `5-fpm-alpine`
42-
* Specific minor versions, such as `5.0`, `5.0-fpm`, and `5-fpm-alpine`
43-
* Specific patch versions, such as `5.0.0`, `5.0.0-fpm`, and `5.0.0-fpm-alpine`. Note that, on rare occasion, there may be an intermediary "docker-only" release, such as 4.9.2-1
40+
- `latest`, `fpm`, and `fpm-alpine` are always the most recent released version
41+
- Major versions, such as `5`, `5-fpm`, and `5-fpm-alpine`
42+
- Specific minor versions, such as `5.0`, `5.0-fpm`, and `5-fpm-alpine`
43+
- Specific patch versions, such as `5.0.0`, `5.0.0-fpm`, and `5.0.0-fpm-alpine`. Note that, on rare occasion, there may be an intermediary "docker-only" release, such as 4.9.2-1
4444

4545
A complete list of tags is [available at Docker Hub](https://hub.docker.com/_/phpmyadmin?tab=tags)
4646

4747
## Image variants
4848

4949
We provide three variations:
5050

51-
* "apache" includes a full Apache webserver with PHP and includes everything needed to work out of the box.
51+
- "apache" includes a full Apache webserver with PHP and includes everything needed to work out of the box.
5252
This is the default when only a version number is requested.
53-
* "fpm" only starts a PHP FPM container. Use this variant if you already have a separate webserver.
53+
- "fpm" only starts a PHP FPM container. Use this variant if you already have a separate webserver.
5454
This includes more tools and is therefore a larger image than the "fpm-alpine" variation.
55-
* "fpm-alpine" has a very small footprint. It is based on Alpine Linux and only starts a PHP FPM process.
55+
- "fpm-alpine" has a very small footprint. It is based on Alpine Linux and only starts a PHP FPM process.
5656
Use this variant if you already have a separate webserver. If you need more tools that are not available on Alpine Linux, use the fpm image instead.
5757

5858
## Usage with linked server
@@ -133,8 +133,8 @@ $cfg['ShowPhpInfo'] = true; // Adds a link to phpinfo() on the home page
133133

134134
See the following links for config file information:
135135

136-
* https://docs.phpmyadmin.net/en/latest/config.html#config
137-
* https://docs.phpmyadmin.net/en/latest/setup.html
136+
- https://docs.phpmyadmin.net/en/latest/config.html#config
137+
- https://docs.phpmyadmin.net/en/latest/setup.html
138138

139139
## Adding custom configuration in `/etc/phpmyadmin/conf.d`
140140

@@ -175,45 +175,45 @@ docker run --name phpmyadmin -d -e PMA_HOSTS='sslhost,nosslhost' -e PMA_SSLS='1,
175175

176176
## Environment variables summary
177177

178-
* ``PMA_ARBITRARY`` - when set to 1 connection to the arbitrary server will be allowed
179-
* ``PMA_HOST`` - define address/host name of the MySQL server
180-
* ``PMA_VERBOSE`` - define verbose name of the MySQL server
181-
* ``PMA_PORT`` - define port of the MySQL server
182-
* ``PMA_HOSTS`` - define comma separated list of address/host names of the MySQL servers
183-
* ``PMA_VERBOSES`` - define comma separated list of verbose names of the MySQL servers
184-
* ``PMA_PORTS`` - define comma separated list of ports of the MySQL servers
185-
* ``PMA_SOCKET`` - define socket file for the MySQL connection
186-
* ``PMA_SOCKETS`` - define comma separated list of socket files for the MySQL connections
187-
* ``PMA_SSL_DIR`` - define the path used for SSL files generated from environement variables, default value is `/etc/phpmyadmin/ssl`
188-
* ``PMA_SSL`` - when set to 1, defines SSL usage for the MySQL connection
189-
* ``PMA_SSLS`` - comma separated list of `0` and `1` defining SSL usage for the corresponding MySQL connections
190-
* ``PMA_SSL_VERIFY`` - when set to 1, enables SSL certificate verification for the MySQL connection.
191-
* ``PMA_SSL_VERIFIES`` - comma-separated list of `0` and `1` to enable or disable SSL certificate verification for multiple MySQL connections.
192-
* ``PMA_SSL_CA`` - in the context of mutual TLS security, allows setting your CA certificate file as a string inside the default `config.inc.php`.
193-
* ``PMA_SSL_CAS`` - in the context of mutual TLS security, allows setting multiple CA certificate files as a comma-separated list of strings inside the default `config.inc.php`.
194-
* ``PMA_SSL_CERT`` - in the context of mutual TLS security, allows setting your certificate file as a string inside the default `config.inc.php`.
195-
* ``PMA_SSL_CERTS`` - in the context of mutual TLS security, allows setting multiple certificate files as a comma-separated list of strings inside the default `config.inc.php`.
196-
* ``PMA_SSL_KEY`` - in the context of mutual TLS security, allows setting your private key file as a string inside the default `config.inc.php`.
197-
* ``PMA_SSL_KEYS`` - in the context of mutual TLS security, allows setting multiple private key files as a comma-separated list of strings inside the default `config.inc.php`.
198-
* ``PMA_USER`` and ``PMA_PASSWORD`` - define username and password to use only with the `config` authentication method
199-
* ``PMA_ABSOLUTE_URI`` - the full URL to phpMyAdmin. Sometimes needed when used in a reverse-proxy configuration. Don't set this unless needed. See [documentation](https://docs.phpmyadmin.net/en/latest/config.html#cfg_PmaAbsoluteUri).
200-
* ``PMA_CONFIG_BASE64`` - if set, this option will override the default `config.inc.php` with the base64 decoded contents of the variable
201-
* ``PMA_USER_CONFIG_BASE64`` - if set, this option will override the default `config.user.inc.php` with the base64 decoded contents of the variable
202-
* ``PMA_UPLOADDIR`` - if defined, this option will set the path where files can be saved to be available to import ([$cfg['UploadDir']](https://docs.phpmyadmin.net/en/latest/config.html#cfg_UploadDir))
203-
* ``PMA_SAVEDIR`` - if defined, this option will set the path where exported files can be saved ([$cfg['SaveDir']](https://docs.phpmyadmin.net/en/latest/config.html#cfg_SaveDir))
204-
* ``PMA_CONTROLHOST`` - when set, this points to an alternate database host used for storing the [phpMyAdmin Configuration Storage database](https://docs.phpmyadmin.net/en/latest/setup.html#phpmyadmin-configuration-storage) database
205-
* ``PMA_CONTROLPORT`` - if set, will override the default port (3306) for connecting to the control host for storing the [phpMyAdmin Configuration Storage database](https://docs.phpmyadmin.net/en/latest/setup.html#phpmyadmin-configuration-storage) database
206-
* ``PMA_PMADB`` - define the name of the database to be used for the [phpMyAdmin Configuration Storage database](https://docs.phpmyadmin.net/en/latest/setup.html#phpmyadmin-configuration-storage). When not set, the advanced features are not enabled by default: they can still potentially be enabled by the user when logging in with the zero conf (zero configuration) feature. Suggested values: `phpmyadmin` or `pmadb`
207-
* ``PMA_CONTROLUSER`` - define the username for phpMyAdmin to use for advanced features (the [controluser](https://docs.phpmyadmin.net/en/latest/config.html#cfg_Servers_controluser))
208-
* ``PMA_CONTROLPASS`` - define the password for phpMyAdmin to use with the [controluser](https://docs.phpmyadmin.net/en/latest/config.html#cfg_Servers_controlpass)
209-
* ``PMA_QUERYHISTORYDB`` - when set [to true](https://docs.phpmyadmin.net/en/latest/config.html#cfg_QueryHistoryDB), enables storing [SQL history](https://docs.phpmyadmin.net/en/latest/config.html#cfg_Servers_history) to the [phpMyAdmin Configuration Storage database](https://docs.phpmyadmin.net/en/latest/setup.html#phpmyadmin-configuration-storage). When [false](https://docs.phpmyadmin.net/en/latest/config.html#cfg_QueryHistoryDB), history is stored in the browser and is cleared when logging out
210-
* ``PMA_QUERYHISTORYMAX`` - when set to an integer, controls the number of history items. See [documentation](https://docs.phpmyadmin.net/en/latest/config.html#cfg_QueryHistoryMax). Defaults to `25`.
211-
* ``MAX_EXECUTION_TIME`` - if set, will override the maximum execution time in seconds (default 600) for phpMyAdmin ([$cfg['ExecTimeLimit']](https://docs.phpmyadmin.net/en/latest/config.html#cfg_ExecTimeLimit)) and PHP [max_execution_time](https://www.php.net/manual/en/info.configuration.php#ini.max-execution-time) (format as `[0-9+]`)
212-
* ``MEMORY_LIMIT`` - if set, will override the memory limit (default 512M) for phpMyAdmin ([$cfg['MemoryLimit']](https://docs.phpmyadmin.net/en/latest/config.html#cfg_MemoryLimit)) and PHP [memory_limit](https://www.php.net/manual/en/ini.core.php#ini.memory-limit) (format as `[0-9+](K,M,G)` where K is for Kilobytes, M for Megabytes, G for Gigabytes and 1K = 1024 bytes)
213-
* ``UPLOAD_LIMIT`` - if set, this option will override the default value for apache and php-fpm (format as `[0-9+](K,M,G)` default value is 2048K, this will change ``upload_max_filesize`` and ``post_max_size`` values)
214-
* ``TZ`` - if defined, this option will change the default PHP `date.timezone` from `UTC`. See [documentation](https://www.php.net/manual/en/timezones.php) for supported values.
215-
* ``HIDE_PHP_VERSION`` - if defined, this option will hide the PHP version (`expose_php = Off`). Set to any value (such as `HIDE_PHP_VERSION=true`).
216-
* ``APACHE_PORT`` - if defined, this option will change the default Apache port from `80` in case you want it to run on a different port like an unprivileged port. Set to any port value (such as `APACHE_PORT=8090`)
178+
- ``PMA_ARBITRARY`` - when set to 1 connection to the arbitrary server will be allowed
179+
- ``PMA_HOST`` - define address/host name of the MySQL server
180+
- ``PMA_VERBOSE`` - define verbose name of the MySQL server
181+
- ``PMA_PORT`` - define port of the MySQL server
182+
- ``PMA_HOSTS`` - define comma separated list of address/host names of the MySQL servers
183+
- ``PMA_VERBOSES`` - define comma separated list of verbose names of the MySQL servers
184+
- ``PMA_PORTS`` - define comma separated list of ports of the MySQL servers
185+
- ``PMA_SOCKET`` - define socket file for the MySQL connection
186+
- ``PMA_SOCKETS`` - define comma separated list of socket files for the MySQL connections
187+
- ``PMA_SSL_DIR`` - define the path used for SSL files generated from environement variables, default value is `/etc/phpmyadmin/ssl`
188+
- ``PMA_SSL`` - when set to 1, defines SSL usage for the MySQL connection
189+
- ``PMA_SSLS`` - comma separated list of `0` and `1` defining SSL usage for the corresponding MySQL connections
190+
- ``PMA_SSL_VERIFY`` - when set to 1, enables SSL certificate verification for the MySQL connection.
191+
- ``PMA_SSL_VERIFIES`` - comma-separated list of `0` and `1` to enable or disable SSL certificate verification for multiple MySQL connections.
192+
- ``PMA_SSL_CA`` - in the context of mutual TLS security, allows setting your CA certificate file as a string inside the default `config.inc.php`.
193+
- ``PMA_SSL_CAS`` - in the context of mutual TLS security, allows setting multiple CA certificate files as a comma-separated list of strings inside the default `config.inc.php`.
194+
- ``PMA_SSL_CERT`` - in the context of mutual TLS security, allows setting your certificate file as a string inside the default `config.inc.php`.
195+
- ``PMA_SSL_CERTS`` - in the context of mutual TLS security, allows setting multiple certificate files as a comma-separated list of strings inside the default `config.inc.php`.
196+
- ``PMA_SSL_KEY`` - in the context of mutual TLS security, allows setting your private key file as a string inside the default `config.inc.php`.
197+
- ``PMA_SSL_KEYS`` - in the context of mutual TLS security, allows setting multiple private key files as a comma-separated list of strings inside the default `config.inc.php`.
198+
- ``PMA_USER`` and ``PMA_PASSWORD`` - define username and password to use only with the `config` authentication method
199+
- ``PMA_ABSOLUTE_URI`` - the full URL to phpMyAdmin. Sometimes needed when used in a reverse-proxy configuration. Don't set this unless needed. See [documentation](https://docs.phpmyadmin.net/en/latest/config.html#cfg_PmaAbsoluteUri).
200+
- ``PMA_CONFIG_BASE64`` - if set, this option will override the default `config.inc.php` with the base64 decoded contents of the variable
201+
- ``PMA_USER_CONFIG_BASE64`` - if set, this option will override the default `config.user.inc.php` with the base64 decoded contents of the variable
202+
- ``PMA_UPLOADDIR`` - if defined, this option will set the path where files can be saved to be available to import ([$cfg['UploadDir']](https://docs.phpmyadmin.net/en/latest/config.html#cfg_UploadDir))
203+
- ``PMA_SAVEDIR`` - if defined, this option will set the path where exported files can be saved ([$cfg['SaveDir']](https://docs.phpmyadmin.net/en/latest/config.html#cfg_SaveDir))
204+
- ``PMA_CONTROLHOST`` - when set, this points to an alternate database host used for storing the [phpMyAdmin Configuration Storage database](https://docs.phpmyadmin.net/en/latest/setup.html#phpmyadmin-configuration-storage) database
205+
- ``PMA_CONTROLPORT`` - if set, will override the default port (3306) for connecting to the control host for storing the [phpMyAdmin Configuration Storage database](https://docs.phpmyadmin.net/en/latest/setup.html#phpmyadmin-configuration-storage) database
206+
- ``PMA_PMADB`` - define the name of the database to be used for the [phpMyAdmin Configuration Storage database](https://docs.phpmyadmin.net/en/latest/setup.html#phpmyadmin-configuration-storage). When not set, the advanced features are not enabled by default: they can still potentially be enabled by the user when logging in with the zero conf (zero configuration) feature. Suggested values: `phpmyadmin` or `pmadb`
207+
- ``PMA_CONTROLUSER`` - define the username for phpMyAdmin to use for advanced features (the [controluser](https://docs.phpmyadmin.net/en/latest/config.html#cfg_Servers_controluser))
208+
- ``PMA_CONTROLPASS`` - define the password for phpMyAdmin to use with the [controluser](https://docs.phpmyadmin.net/en/latest/config.html#cfg_Servers_controlpass)
209+
- ``PMA_QUERYHISTORYDB`` - when set [to true](https://docs.phpmyadmin.net/en/latest/config.html#cfg_QueryHistoryDB), enables storing [SQL history](https://docs.phpmyadmin.net/en/latest/config.html#cfg_Servers_history) to the [phpMyAdmin Configuration Storage database](https://docs.phpmyadmin.net/en/latest/setup.html#phpmyadmin-configuration-storage). When [false](https://docs.phpmyadmin.net/en/latest/config.html#cfg_QueryHistoryDB), history is stored in the browser and is cleared when logging out
210+
- ``PMA_QUERYHISTORYMAX`` - when set to an integer, controls the number of history items. See [documentation](https://docs.phpmyadmin.net/en/latest/config.html#cfg_QueryHistoryMax). Defaults to `25`.
211+
- ``MAX_EXECUTION_TIME`` - if set, will override the maximum execution time in seconds (default 600) for phpMyAdmin ([$cfg['ExecTimeLimit']](https://docs.phpmyadmin.net/en/latest/config.html#cfg_ExecTimeLimit)) and PHP [max_execution_time](https://www.php.net/manual/en/info.configuration.php#ini.max-execution-time) (format as `[0-9+]`)
212+
- ``MEMORY_LIMIT`` - if set, will override the memory limit (default 512M) for phpMyAdmin ([$cfg['MemoryLimit']](https://docs.phpmyadmin.net/en/latest/config.html#cfg_MemoryLimit)) and PHP [memory_limit](https://www.php.net/manual/en/ini.core.php#ini.memory-limit) (format as `[0-9+](K,M,G)` where K is for Kilobytes, M for Megabytes, G for Gigabytes and 1K = 1024 bytes)
213+
- ``UPLOAD_LIMIT`` - if set, this option will override the default value for apache and php-fpm (format as `[0-9+](K,M,G)` default value is 2048K, this will change ``upload_max_filesize`` and ``post_max_size`` values)
214+
- ``TZ`` - if defined, this option will change the default PHP `date.timezone` from `UTC`. See [documentation](https://www.php.net/manual/en/timezones.php) for supported values.
215+
- ``HIDE_PHP_VERSION`` - if defined, this option will hide the PHP version (`expose_php = Off`). Set to any value (such as `HIDE_PHP_VERSION=true`).
216+
- ``APACHE_PORT`` - if defined, this option will change the default Apache port from `80` in case you want it to run on a different port like an unprivileged port. Set to any port value (such as `APACHE_PORT=8090`)
217217

218218
For usage with Docker secrets, appending ``_FILE`` to the ``PMA_PASSWORD`` environment variable is allowed (it overrides ``PMA_PASSWORD`` if it is set):
219219

@@ -223,28 +223,28 @@ docker run --name phpmyadmin -d -e PMA_PASSWORD_FILE=/run/secrets/db_password.tx
223223

224224
#### Variables that can store the file contents using ``_BASE64``
225225

226-
- `PMA_SSL_CA`
227-
- `PMA_SSL_CAS`
228-
- `PMA_SSL_KEY`
229-
- `PMA_SSL_KEYS`
230-
- `PMA_SSL_CERT`
231-
- `PMA_SSL_CERTS`
226+
- `PMA_SSL_CA`
227+
- `PMA_SSL_CAS`
228+
- `PMA_SSL_KEY`
229+
- `PMA_SSL_KEYS`
230+
- `PMA_SSL_CERT`
231+
- `PMA_SSL_CERTS`
232232

233233
Also includes: `PMA_CONFIG_BASE64` or `PMA_USER_CONFIG_BASE64`.
234234

235235
For example, the variable would be named `PMA_SSL_CA_BASE64` and the value is the base64 encoded contents of the file.
236236

237237
#### Variables that can be read from a file using ``_FILE``
238238

239-
- `MYSQL_ROOT_PASSWORD`
240-
- `MYSQL_PASSWORD`
241-
- `PMA_USER`
242-
- `PMA_PASSWORD`
243-
- `PMA_HOSTS`
244-
- `PMA_HOST`
245-
- `PMA_CONTROLHOST`
246-
- `PMA_CONTROLUSER`
247-
- `PMA_CONTROLPASS`
239+
- `MYSQL_ROOT_PASSWORD`
240+
- `MYSQL_PASSWORD`
241+
- `PMA_USER`
242+
- `PMA_PASSWORD`
243+
- `PMA_HOSTS`
244+
- `PMA_HOST`
245+
- `PMA_CONTROLHOST`
246+
- `PMA_CONTROLUSER`
247+
- `PMA_CONTROLPASS`
248248

249249
## Run the E2E tests for this docker image
250250

0 commit comments

Comments
 (0)