| | 1 | == Debugging SIWAPP == |
| | 2 | |
| | 3 | This is a very simple trick to gain some more info when something's not going right with siwapp. |
| | 4 | |
| | 5 | Since SIWAPP is released as a "production environment" release (not meaning it's "production ready"), the error messages and logs are disabled by default. |
| | 6 | |
| | 7 | If you want to access error messages and logs, you need to activate the "development environment" by editing a few things at the index.php file and creating a "log" folder: |
| | 8 | |
| | 9 | - Find the following line at the web/index.php file |
| | 10 | {{{ |
| | 11 | $configuration = ProjectConfiguration::getApplicationConfiguration('siwapp','prod',false); |
| | 12 | }}} |
| | 13 | - The second and third argument of the ''ProjectConfiguration::getApplicationConfiguration'' function are the environment and the show debug messages flag. They come by default as '' 'prod' '', for "production environment" and ''false'' to disable error messages. If you switch that line to: |
| | 14 | {{{ |
| | 15 | $configuration = ProjectConfiguration::getApplicationConfiguration('siwapp','prod',true); |
| | 16 | }}} |
| | 17 | you'll still get the "production environment" but this time you also get error messages. If you also switch the 'prod' arg, and then get the line as: |
| | 18 | {{{ |
| | 19 | $configuration = ProjectConfiguration::getApplicationConfiguration('siwapp','dev',false); |
| | 20 | }}} |
| | 21 | you'll also get the "development environment", which means the cache is refreshed on every request. It also means lots of logs messages, which implies the need for a log folder, or you'll be overwhelmed by angry messages from the server. You need to create a ''log'' folder at the same level the lib, cache, apps, doc folders are. YOU ALSO NEED TO GIVE THE SERVER WRITE PERMISSIONS TO THAT FOLDER |
| | 22 | |
| | 23 | Well, that would be all. It would be easier to get answers at the forums if you post the error messages obtained by means of using the "dev" environment and the flag for debugging. |
| | 24 | |
| | 25 | This is a very quick, dirty and rough guide, probably full of typos and other awfull things. Please do feel free to contact me at the forums if you have suggestions, comments or whatever. |
