Troubleshooting

Table of Contents Xataface Troubleshooting All I get is a blank white screen! Locating your php.ini file Common Issues When Building your First App

Xataface Troubleshooting

This document is intended to help Xataface developers through some of the most common issues.

toc

All I get is a blank white screen!

The most common issue mentioned in the forums is that an application comes up with a blank white screen in the web browser. This can happen for a number of reasons but the most common reason is because PHP has encountered a fatal error and your PHP installation is not set up to display errors.

The first step to troubleshooting this problem must be to find out what the error is. You can do that in one of the following ways:

1. Check your Apache error log if you know where it is. One common location on many linux installations is /var/log/httpd/error_log

but your system may have it located elsewhere. If you cannot find your error log, continue to the next option.

1. Turn on the display_errors flag in your php.ini file. I.e., in your php.ini file, find where it says display_errors Off

and change it to display_errors On . After this is done, restart your apache webserver. If you don't know where your php.ini file is located see the section later in this document on locating your php.ini file. If you don't have access to your php.ini file, move on to the next option.

1. In your application's .htaccess file, add the following directives to enable displaying errors:php_flag display_errors on

. Note that this method will only work if your apache config file allows you to override these values at the directory level. If you still get a blank white screen after this, continue to the next option.

1. At the beginning of your application's index.php file, add the following:<?php

error_reporting(E_ALL); ini_set('display_errors', 'on'); . Note that if the error occurs in the parsing or compiling of your PHP files you will still get a blank screen. But this will at least display runtime errors on the page.

Once you can see the error messages that caused the blank white screen you are in a much better position to solve the problem.

Locating your php.ini file

Locating your php.ini file is actually quite easy. The quickest way is to create a php script with the following contents: <?php phpinfo(); then navigate to this page in your web browser. This look at the line where it says the php.ini file. It will list the path there.

Common Issues When Building your First App

This blog post discusses some common issues you may encounter when creating your first Xataface application.