I get a blank page when I try to install UserFrosting.
If you are using Apache (the default web server that comes installed with WAMP, XAMPP, and most shared web hosting services), check that you have the Rewrite Engine module (mod_rewrite.c) installed and enabled.
Some distributions, like WAMP, may not have this module automatically enabled, and you will need to do so manually.
In a shared hosting environment, you may need to have your hosting service do this for you.
If you have shell access to your server, please take the following steps (from Stack Overflow):
Open up your console and type into it: sudo a2enmod rewrite
Restart your apache server: service apache2 restart
You may also, in addition to the above, if it does not work, have to change the override rule from the apache conf file (either apache2.conf, http.conf , or 000-default file).
Locate "Directory /var/www/"
Change the "Override None" to "Override All"
If you get an error stating rewrite module is not found, then probably your userdir module
is not enabled. For this reason you need to enable it.
Type this into the console: sudo a2enmod userdir
Then try enabling the rewrite module if still not enabled (as mentioned above).
Make sure that your system meets the minimum requirements. In particular, you must have PHP 5.4 or higher installed.
If you are sure that you have the Rewrite module enabled and properly configured, make sure that you have your database credentials properly set in config-userfrosting.php. See Installing UserFrosting for more details.
UF doesn't seem to work on nginx or IIS.
Currently, UserFrosting only comes with a configuration file for Apache. So, we do not yet "officially" support nginx or IIS (but we hope to soon!)
If you are proficient in IIS or other server technologies, and wish to contribute the corresponding configuration file, please open a pull request - we'd really appreciate it!
In the meantime, there may be a workaround: you can install Helicon Ape, which provides support for Apache .htaccess and .htpasswd configuration files in Microsoft IIS. Choose "full server download" when prompted by the Helicon Ape installer.
I'm using an Apache alias for my site and I get 404 errors when trying to install.
Assuming your Apache alias maps /project to C:/WebProject/, you'll be accessing the installer at http://example.com/project/public/, but your 404 error will be showing /WebProject/public/index.php instead.
The problem here is that mod_rewrite is incorrectly pointing to the directory itself (WebProject) rather than the alias name (project).
To correct this, you’ll need to figure out the proper RewriteBase to use based on your alias and the 404 error. Add a line in /public/.htaccess after "RewriteEngine On":
This line will direct mod_rewrite to use the Apache alias. Once this is done, you can re-run the installer by going to http://example.com/project/public again.
I get warnings about the GD library and/or imagepng during installation.
Occasionally, people use web hosting services that do not provide the GD library, or provide it but do not have it enabled. The GD library is an image processing module for PHP. UserFrosting uses it to generate the captcha code for new account registration.
Nothing happens after I press "register" to create the master account.
There is probably an error, but it is not being displayed because your server is returning an HTTP 200 - OK instead of the error code it is supposed to. You can confirm this by checking in your browser console for the POST request to /install/master.
See, UserFrosting is built on the principles of REST, which says that we should use the native HTTP status codes when communicating with the server. When you submit something to a UserFrosting application, the server side returns a code such as:
200 - OK
500 - Internal server error
400 - Bad request
403 - Forbidden
404 - Not found
On the client side, UserFrosting uses these HTTP codes to determine what action to take after the response is received. Thus, if it receives HTTP 200 - OK, it will assume the request was successful. So, thinking that the master account creation was successful, UF tries to forward you to the home page. But when it gets there, UF sees that the master account was in fact not successful, so it takes you back to the registration page, thus making it seem like the registration page just refreshed.
We are not yet sure why some servers are returning the wrong HTTP status code. This problem has been reported on the Slim forums as well. It may be a problem due to caching, buffering, or certain reverse proxy configurations.
Our suggestion for now, if you're having this problem, is to contact your hosting service and explain that the server does not seem to be preserving your response headers correctly.
I created a new class, but UserFrosting doesn't seem to recognize it.
You need to install Composer, PHP's dependency manager. In addition to automatically loading external packages, Composer also autoloads the class files for your project. When you add a new class, you must run composer update in the userfrosting directory (the same directory that contains composer.json). Make sure that you have installed Composer globally.
Composer gives me errors when I run composer update.
When this happens, you might get an error message complaining about a .git directory missing in vendor. To solve this problem, simply delete the vendor/alexweissman directory and re-run composer update.