From a4dbb6fbeac54e393a44eef51f61cb59e08f35f9 Mon Sep 17 00:00:00 2001
From: Alexander Makarov <sam@rmcreative.ru>
Date: Wed, 15 Oct 2014 03:48:42 +0400
Subject: [PATCH] Started shared hosting guide

---
 docs/guide/README.md                  |  2 +-
 docs/guide/tutorial-shared-hosting.md | 65 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 66 insertions(+), 1 deletion(-)
 create mode 100644 docs/guide/tutorial-shared-hosting.md

diff --git a/docs/guide/README.md b/docs/guide/README.md
index 224132a..8b0b6cf 100644
--- a/docs/guide/README.md
+++ b/docs/guide/README.md
@@ -169,7 +169,7 @@ Special Topics
 * [Internationalization](tutorial-i18n.md)
 * [Mailing](tutorial-mailing.md)
 * [Performance Tuning](tutorial-performance-tuning.md)
-* **TBD** [Shared Hosting Environment](tutorial-shared-hosting.md)
+* [Shared Hosting Environment](tutorial-shared-hosting.md)
 * [Template Engines](tutorial-template-engines.md)
 * [Working with Third-Party Code](tutorial-yii-integration.md)
 
diff --git a/docs/guide/tutorial-shared-hosting.md b/docs/guide/tutorial-shared-hosting.md
new file mode 100644
index 0000000..7940477
--- /dev/null
+++ b/docs/guide/tutorial-shared-hosting.md
@@ -0,0 +1,65 @@
+Shared Hosting Environment
+==========================
+
+Shared hosting environments are often quite limited about configuration and directory structure. Still in most cases
+you can run Yii 2.0 on these.
+
+Deploying basic application
+---------------------------
+
+Since there's typically only one webroot it is recommended to use basic application template. Refer to
+[Installing Yii chapter](start-installation.md) and install application template locally.
+
+### Add extras for webserver
+
+If webserver used is Apache you'll need to add `.htacces` file with the following content to `web`
+(where `index.php` is):
+
+```
+Options +FollowSymLinks
+IndexIgnore */*
+
+RewriteEngine on
+
+# if a directory or a file exists, use it directly
+RewriteCond %{REQUEST_FILENAME} !-f
+RewriteCond %{REQUEST_FILENAME} !-d
+
+# otherwise forward it to index.php
+RewriteRule . index.php
+```
+
+In case of nginx you should not need any extra config files.
+
+### Renaming webroot
+
+If after connecting to your shared hosting via FTP or by other means you're seeing something like the following, you're
+most probably lucky.
+ 
+```
+config/
+logs/
+www/
+```
+
+In the above `www` is webserver directory root (i.e. webroot). It could be named differently. Common names are: `www`,
+`htdocs`, `public_html`. Since we have webroot in our basic application template named `web` we need to rename it to
+whatever hosting webroot is before uploading.
+
+### FTP root directory is writeable
+
+If you can write to the root level directory i.e. where `config`, `logs` and `www` are, just upload `assets`, `commands`
+etc. as is.
+
+### Check requirements
+
+In order to run Yii hosting should meet its requirements. The very minimum requirement is PHP 5.4. In order to check
+the rest copy `requirements.php` from root directory into webroot directory and run it via browser using
+`http://example.com/requirements.php` URL. Don't forget to delete the file afterwards.
+
+
+Deploying advanced application
+------------------------------
+
+Deploying advanced application to shared hosting is a bit trickier than doing it with basic application because it has
+two webroots.
\ No newline at end of file
--
libgit2 0.27.1