Tweaks
This section guides you on how to tweak and configure phpbrowserbox.
Table of Contents
The base configuration file is located at conf/phpbrowserbox.ini
[USER]
TITLE=PHPBrowserBox Application v6.0
VERSION=6.0.0
WIDTH=832
HEIGHT=567
DEVTOOLS=0
SERVERALWAYSON=1
The configuration values are explained below:
-
TITLE : the title of your application. This is what displays when you launch phpbrowserbox
-
VERSION: this is just a place holder telling you the version of PHPBrowserBox, you can delete this key without any consequence
*WIDTH: the original width of the application
*HEIGHT: the original height of the application
DEVTOOLS: this is either true (1) or false (0). When set to 1, devtools will be loaded on startup. Note that you can start devtools at anytime by pressing control + shift + i.
*SERVERALWAYSON: this is either true (1) or false (0). When set to 1, phpbrowserbox will not shut down the server when it is closed (unlike previous versions before 6.0 that automatically shutdown the server when you close). The result of this is a faster startup time next time you start phpbrowserbox.
Note: You can still shutdown the server with bbcpanel.
The executable name of the application phpbrowserbox.exe and you will find this in the root folder of app, you may not see the extension .exe if you do not configure your pc to view file name extensions.
To change the executable icon, you have 2 options:
- Recompile the source code of phpbrowserbox launcher with a new icon.
- Use resource hacker to change the executable icon.
The Apache server is inside the bin/apache folder. / The configuration file is located at bin/apache/conf/httpd-tpl.conf. Any changes made into this is transpiled to bin/apache/conf/httpd.conf at run-time.
This means that any change you make directory to httpd.conf will be discarded at next restart.
Configuration updates should be made to httpd-tpl.conf.
If you delete httpd-tpl.conf e.g. you replace the apache binary folder with a new one. At next restart httpd-tpl.conf will be recreated if none is found.
The php binary is inside the bin/php folder. / The configuration file is located at bin/php/php-tpl.ini. Any changes made into this is transpiled to bin/php/php.ini at run-time.
This means that any change you make directory to my.ini will be discarded at next restart.
Configuration updates should be made to my-tpl.ini.
PHPBrowserbox has been tested with PHP Version 5.5 to 8.2. Ensure that whatever replacement you are using supports apache.
If you delete php-tpl.ini e.g. you replace the php binary folder with a new one. At next restart php-tpl.ini will be recreated if none is found.
The MySQL server is inside the bin/mysql folder. / The configuration file is located at bin/mysql/my-tpl.ini. Any changes made into this is transpiled to bin/mysql/my.ini at run-time.
This means that any change you make directory to my.ini will be discarded at next restart.
Configuration updates should be made to my-tpl.conf.
If you delete my-tpl.conf e.g. you replace the mysql binary folder with a new one. At next restart my-tpl.conf will be recreated if none is found.
Finally, do disable mysql. Just remove/delete the folder when the server is stopped. That is all it takes.
Anytime phpbrowserbox launch. It displays 2 splash screen images.
-
installing.png : this displays installing message when phpbrowserbox server is being setup. The first time is usually the longest. Subsequent loads are faster. This first splashscreen is displayed showing an installing message.
-
loading.png : this displays when the browser is loading the home page i.e. http://localhost (or whatever port is used)
In customizing your application, you should replace these two images.