It's highly recommended to double check if all the Appskull files are uploaded into the web sever and you've followed all the Appskull installation steps correctly. and also it's highly recommended to read this whole troubleshooting chapter before you attempt to fix errors.
The easiest way that you can diagnose errors in Appskull is simply look into the
logs directory that located in Appskull root directory. If there are any logs files exists, Then you can open them and try to identify errors and diagnose them.
For security reasons Appskull won't show any errors by default. Instead it will throw a blank page. Because throwing errors can reveal sensitive information about your server environment and Appskull installation. That is really bad for the security. Now you know that why you get a blank page in Appskull when having an error. This behavior may good for security. But this behavior make it hard to diagnose errors.
But you can easily change this default behavior by following bellow steps:
index.php file in the Appskull root directory.
Change application environment to development from production.
index.php file and re-upload to the server.
Now you can reload the Appskull on your web browser and see if any PHP errors throw.
production. This is very important for security.
The following errors can occur due to wrong server/Appskull configurations. But these errors can be easily diagnosed and fixed.
Some PHP errors can occur due to old PHP versions that running on your webserver. So make sure you got all the Appskull minimum server requirements. You can find those information in the installation chapter.
If you are not sure about how to check what PHP and other application server versions are running on your web server, you can run a simple phpinfo() diagnose. The phpinfo() function can be used to output a large amount of information about your PHP installation and can be used to identify installation and configuration problems. To run the function, just create a new file called phpinfo.php and place it into the root directory of your web server. Now open the file in a text editor and add the following content:
After saving the file, just point your web browser at it to view its result (i.e., open http://[server host]/phpinfo.php). You should see something like the following output. This information can also be useful for identify application server versions and other important information.
Some PHP errors can occur due to lack of read write permissions for Appskull system folders. So make sure to grant appropriate file system permissions for Appskull system folders. Specially make sure
views directories have write permissions.
You can go to your Appskull root directory and execute
sudo chmod -R 755 * or
sudo chmod -R 777 * terminal command in order to grant all file system permissions to Appskull directories.
In order to fix this error you can enable mod rewrite module in your apache web server or follow bellow steps:
.htaccess file in your Appskull root directory.
$config['index_page'] = ''; configuration item in
config.php file that located under
[app_root]/app/config directory as
$config['index_page'] = 'index.php';.
index.php file and re-upload that file into the server.
In order to fix this error, you have to review database related configuration values in
[app_root]/app/config/database.php file and make them correct.
Error 404 on Apache web server.
Error 404 on Nginx web server.
This error can occur in both
Nginx web servers due to incorrect
$config['base_url'] configuration in
[app_root]/app/config/config.php file. So be sure to review that configuration value and correct it in-order to fix this error.
$config['base_url'] configuration correct, this error can occur in
Nginx web server due to lack of Appskull Nginx directive rules in
nginx.conf file or incorrect Appskull Nginx directive rules in
nginx.conf file. In order to fix this error, you have to add or correct those Appskull Nginx directive rules in
nginx.conf file. You can get more information about these Appskull Nginx directive rules from installation chapter.