diff --git a/docs/guide/start-installation.md b/docs/guide/start-installation.md
index 8c0d8fbd30..ef6c591616 100644
--- a/docs/guide/start-installation.md
+++ b/docs/guide/start-installation.md
@@ -103,7 +103,9 @@ Configuring Web Servers <a name="configuring-web-servers"></a>
 
 The application installed according to the above instructions should work out of box with either
 an [Apache HTTP server](http://httpd.apache.org/) or an [Nginx HTTP server](http://nginx.org/), on
- Windows, Mac OS X, or Linux.
+Windows, Mac OS X, or Linux running PHP 5.4 or higher. Yii 2.0 is also compatible the facebooks
+[HHVM](http://hhvm.com/) however there are some edge cases where HHVM behaves different than native
+PHP so you have to take some extra care when using HHVM.
 
 On a production server, you may want to configure your Web server so that the application can be accessed
 via the URL `http://www.example.com/index.php` instead of `http://www.example.com/basic/web/index.php`. Such configuration
diff --git a/framework/rbac/PhpManager.php b/framework/rbac/PhpManager.php
index 64698048cb..ce5fe4148b 100644
--- a/framework/rbac/PhpManager.php
+++ b/framework/rbac/PhpManager.php
@@ -23,6 +23,9 @@ use yii\helpers\VarDumper;
  * (for example, the authorization data for a personal blog system).
  * Use [[DbManager]] for more complex authorization data.
  *
+ * Note that PhpManager is not compatible with facebooks [HHVM](http://hhvm.com/) because
+ * it relies on writing php files and including them afterwards which is not supported by HHVM.
+ *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @author Alexander Kochetov <creocoder@gmail.com>
  * @author Christophe Boulain <christophe.boulain@gmail.com>
diff --git a/tests/unit/framework/console/controllers/POMessageControllerTest.php b/tests/unit/framework/console/controllers/POMessageControllerTest.php
index 95d4e2fae5..6209a4c611 100644
--- a/tests/unit/framework/console/controllers/POMessageControllerTest.php
+++ b/tests/unit/framework/console/controllers/POMessageControllerTest.php
@@ -17,6 +17,11 @@ class POMessageControllerTest extends BaseMessageControllerTest
     public function setUp()
     {
         parent::setUp();
+
+        if (defined('HHVM_VERSION')) {
+            $this->markTestSkipped('POMessageControllerTest can not run on HHVM because it relies on saving and re-including PHP files which is not supported by HHVM.');
+        }
+
         $this->messagePath = Yii::getAlias('@yiiunit/runtime/test_messages');
         FileHelper::createDirectory($this->messagePath, 0777);
     }
diff --git a/tests/unit/framework/rbac/PhpManagerTest.php b/tests/unit/framework/rbac/PhpManagerTest.php
index adc4ac9680..7e2214c2e4 100644
--- a/tests/unit/framework/rbac/PhpManagerTest.php
+++ b/tests/unit/framework/rbac/PhpManagerTest.php
@@ -72,6 +72,11 @@ class PhpManagerTest extends ManagerTestCase
         static::$filemtime = null;
         static::$time = null;
         parent::setUp();
+
+        if (defined('HHVM_VERSION')) {
+            $this->markTestSkipped('PhpManager is not compatible with HHVM.');
+        }
+
         $this->mockApplication();
         $this->removeDataFiles();
         $this->auth = $this->createManager();