Improved docs

This commit is contained in:
Dmitry Khomutov 2016-07-19 15:12:28 +06:00
commit 320a249153
49 changed files with 454 additions and 193 deletions

View file

@ -1,8 +1,12 @@
Adding a Virtual Host
---------------------
In order to access the PHPCI web interface, you need to set up a virtual host in your web server.
Below are a few examples of how to do this for various different web servers.
## Nginx Example:
Nginx Example
=============
```
server {
@ -24,7 +28,8 @@ server {
}
```
## Apache Example:
Apache Example
==============
For Apache, you can use a standard virtual host, as long as your server supports PHP. All you need to do is add the following to a `.htaccess` file in your PHPCI `/public` directory.
@ -38,7 +43,6 @@ For Apache, you can use a standard virtual host, as long as your server supports
</IfModule>
```
### Installing in Vagrant
- Edit virtual host in apache2.
```
<VirtualHost *:80>
@ -57,41 +61,13 @@ For Apache, you can use a standard virtual host, as long as your server supports
</VirtualHost>
```
- In Mac OS X add in /etc/hosts
- Add in /etc/hosts
```
127.0.0.1 phpci.vagrant
```
## Other Servers
### Lighttpd Example (lighttpd >= `1.4.24`):
This example uses the `$HTTP["host"]` conditional block because `$HTTP["url"]` blocks aren't supported with url rewriting in lighttpd <= `1.4.33` (source: [lighttpd docs for mod_rewrite](http://redmine.lighttpd.net/projects/1/wiki/Docs_ModRewrite)). In lighttpd >= `1.4.34` however, [this has been fixed](http://redmine.lighttpd.net/issues/2526).
### lighttpd <= `1.4.33`
```
$HTTP["host"] =~ "^phpci\.example\.com$" {
# Rewrite all requests to non-physical files
url.rewrite-if-not-file =
(
"^(.*)$" => "index.php/$1"
)
}
```
### lighttpd >= `1.4.34`
```
$HTTP["url"] =~ "^\/PHPCI/$" {
# Rewrite all requests to non-physical files
url.rewrite-if-not-file =
(
"^(.*)$" => "index.php/$1"
)
}
```
If you ~~would like~~ are forced to use lighttpd <= `1.4.24`, [you can use mod_magnet and Lua instead] (http://redmine.lighttpd.net/projects/1/wiki/AbsoLUAtion).
### Built-in PHP Server Example:
Built-in PHP Server Example
===========================
You can use the built-in PHP server `php -S localhost:8080` by adding `public/routing.php`.