Troubleshooting
Handler Names
Make sure to put all your handler names in your controller as a comma separated list into the global
variable gControllerHandlers, otherwise you get a "Page Not Found" error.
See the comments in the sample files in the application/controllers folder.
Error Logging
If you enable error logging in application/config/config.lc make sure that the system/logs folder is writable.
Search-Engine Friendly URLs
If you find that no matter what you put in your URL only your default page is loading, it might be that your server
does not support the PATH_INFO variable needed to serve search-engine friendly URLs. This does not apply to the
On-Rev hosting service.
As a first step, open your application/config/config.lc file and look for the URI Protocol
information. It will recommend that you try a couple alternate settings. If it still doesn't work you may try to use
query string based URLs by setting gConfig["enableQueryStrings"] in the config.lc file to TRUE.
Setting Headers and Cookies
If you have problems setting headers or cookies watch out for whitespace. Make sure that there is no whitespace before the <?rev tag of your script files and that no whitespace follows the terminating "?>" tag. Generally it is better to leave terminating "?>" tags off, this way whitespace at the end of the script does not accidentally output content to the browser. Furthermore make sure that your files are not saved using UTF-8 (BOM). Using BOM prevents changing any header because characters are sent prior to sending headers, this means headers you set or cookies can not be sent.
gData Variables
If you use LiveCode server prior to version 6.1.3 dont't forget to add a space between the right array bracket and the merge brackets of your gData variables in your view files.
Code in View Files
Keep in mind, that using return statements enclosed in "<?" and "?>" is the only way to include LiveCode in your view files like in the following example:
<? put "<ul>" into tToDo
repeat for each item thisItem in gData["toDoList"]
put "<li>" & thisItem & "</li>" after tToDo
end repeat
put "</ul>" after tToDo
return tToDo ?>
Lion and Mountain Lion
There is a bug (9869) in LiveCode Server confirmed by RunRev. LiveCode Server versions 4.6.3 up to 5.0.2 have two incorrect path environment variables on Lion and Mountain Lion. These variables are:
- $_SERVER["PATH_TRANSLATED"]
- $_SERVER["PATH_INFO"]
Note: This issue is fixed in LiveCode Server release: 6.0.0-rc-1.
Email Library
As of server version 7.0.6-rc-1 the SMTP protocol is not available on Linux because the commands open socket with message and write to socket are still not working in the Linux server engine. On Mac OS X SMTP should work as expected since server version 7.0.1.
Update: Sockets work in Linux server engine since version 7.1.0 RC 1 too. This means you can use the SMTP protocol on Linux.
Update: This issue reappeared with LC server version 8.0.0 and applies to all socket callback messages. So, sending emails using SMTP is broken again.
Trackback Library
As of server version 7.0.6-rc-1 the Trackback library does not work on Linux because the write to socket command is still not working in the Linux server engine. On Mac OS X Trackback should work as expected since server version 7.0.1.
Update: Sockets work in Linux server engine since version 7.1.0 RC 1 too. This means you can use the Trackback library on Linux.
Update: This issue reappeared with LC server version 9.0.0 on Mac OS X.