Configuration

The application configuration class Boson\ApplicationCreateInfo is optional and serves as a convenient way to define default settings for initializing your app.

#Application Name

The name of the application.

$appConfig = new Boson\ApplicationCreateInfo( 
    name: 'Example Application',
);

The value is optional and can be used for user needs, as well as for internal ones.

For example as a WindowClass (WNDCLASS.lpszClassName) identifier on Windows OS.

#Intercepted Schemes

Defines custom schemes that your application can handle. These schemes allow you to create custom protocols for your application.

$appConfig = new Boson\ApplicationCreateInfo( 
    schemes: [ 'boson' ], // Default is empty array
);

More detailed information about the schemes is available on the Schemes API page.

Each registered scheme in this list will produce a SchemeRequestReceived intention when attempting to access a resource located at an address with this protocol.

#Threads Count

Specifies the number of physical threads for the webview applications (not PHP). This affects how many concurrent operations your webviews can handle.

$appConfig = new Boson\ApplicationCreateInfo( 
    threads: 4, // Default is null
);

If the value is not specified (defined as null), the number of threads will correspond to the number of cores in the CPU.

#Debug Mode

Enables or disables debug features, like dev tools and logging. When enabled, provides additional diagnostic information and developer tools.

$appConfig = new Boson\ApplicationCreateInfo( 
    debug: true, // Default is null
);

If the value is not specified, the debug mode will be set according to the current php.ini settings (depends on whether you are using the development php.ini settings)

The debug mode settings also affects the default settings of child configurations, such as developer tools (if they are not set explicitly).

#Application Library

Specifies the path to a custom frontend library that should be loaded with the application.

$appConfig = new Boson\ApplicationCreateInfo( 
    library: __DIR__ . '/path/to/custom/library.dll', // Default is null
);

In most cases this is not required and the library will be selected automatically based on the current operating system and CPU architecture.

#Quit On Close

Deprecated Since 0.18: The configuration flag still allows to disable this behavior, but it is recommended to disable the QuitOnCloseExtension extension instead.

Determines whether the application should terminate when all windows are closed. If set to false, the application will continue running in the background.

$appConfig = new Boson\ApplicationCreateInfo( 
    quitOnClose: true, // Default is true
);

#Autorun

Deprecated Since 0.18: The configuration flag still allows to disable this behavior, but it is recommended to disable the AutorunExtension extension instead.

Responsible for automatic application launch. If autorun is set to false, you will need to launch the application yourself at the moment when it is needed.

$appConfig = new Boson\ApplicationCreateInfo( 
    autorun: false, // Default is true
);