If you are using phar and want to encode it or encode some of the files within your phar with SourceGuardian, there are two simple rules to follow:

 

1) Do not encode the entire phar file. Encode files you add to phar.

2) Do not encode a stub script if you use your own or use standard stub.

 

With SourceGuardian you may intercept licensing and other errors and also an error regarding a missed loader, if users of your protected code are trying to run it without installing the loader. You may use either a standard PHP error handling mechanism or add a custom error handling function which will catch script licensing and other errors. The latter is preferred. An error handler is a function which accepts two parameters:

 

my_error_handler( $code , $message )

 

Use any name for this function and you may have different functions for different types of errors. The first argument is an error code. The second one contains a default error message. It's important that the error handling functions must be available before the encoded code starts, i.e. all the error handlers must remain unencoded. The best place to add the handler functions is a "custom header", please see Advanced Options in project settings and the code you place to the custom header may look like this (do not forget php tags):

 

 

<?php

if(!function_exists('my_error_handler')){

    function my_error_handler($code, $message) {

?    ?    ??echo sprintf("Custom SourceGuardian general error handler - code=%s", $code);

    }

}

?>

 

Then assign your error handler function to the error condition on the Lock page. Note, you may have different handlers for the error codes or use one code to catch all the errors.

 

 

Finally, encode your project. If you check the encoded file in the editor, you should be able to see the error handler function added to the top of every encoded PHP file. Do not modify the encoded files! If you need to change your error handler, edit it in Custom Header in Advanced Options and then re-encode. Note, we do not check this code for any errors.

 

Please refer to our user manual for further information about error handling. Also you may find in the manual how to use standard PHP mechanism to catch SourceGuardian errors. 

 

Download sample files from our website if you need a sample or if you use a command line encoder, the samples include a shell script with necessary encoding options.