Edit me

    Configuration

    Phel comes with some configuration options. They are stored in the phel-config.php file in the root directory of every project.

    Structure#

    These are all Phel specific configuration options available, along with the values that are set by default.

    <?php
// phel-config.php
return (new \Phel\Config\PhelConfig())
    ->setSrcDirs(['src/phel'])
    ->setTestDirs(['tests/phel'])
    ->setVendorDir('vendor')
    ->setOut((new PhelOutConfig())
        ->setMainPhelNamespace('your-ns\main')
        ->setMainPhpPath('out/main.php'))
    ->setExport((new \Phel\Config\PhelExportConfig())
        ->setDirectories(['src/phel'])
        ->setNamespacePrefix('PhelGenerated')
        ->setTargetDirectory('src/PhelGenerated'))
    ->setIgnoreWhenBuilding(['src/phel/local.phel'])
    ->setNoCacheWhenBuilding(['src/phel/local.phel'])
    ->setFormatDirs(['src', 'tests'])
    ->setKeepGeneratedTempFiles(false)
;

    Options in detail#

    This chapter contains all configuration options explained in detail.

    SrcDirs#

    Set a list of directories in which the source files for the project are located.

    <?php
return (new \Phel\Config\PhelConfig())
    ->setSrcDirs(['src/phel'])
    # ...
;

    TestDirs#

    Set a list of directories in which the test files are located.

    <?php
return (new \Phel\Config\PhelConfig())
    ->setTestDirs(['tests/phel'])
    # ...
;

    VendorDir#

    Set the name of the composer vendor directory. Default is vendor.

    <?php
return (new \Phel\Config\PhelConfig())
    ->setVendorDir('vendor')
    # ...
;

    OutConfig#

    The configuration when running the phel build command.

    <?php
return (new \Phel\Config\PhelConfig())
    ->setOut((new PhelOutConfig())
        ->setMainPhelNamespace('your-ns\main')
        ->setMainPhpPath('out/main.php'))
    # ...
;
    • setMainPhelNamespace: the main phel namespace to start transpiling the Phel code.
    • setMainPhpPath: the entry point of the build PHP result.

    ExportConfig#

    Set configuration options that are being used for the phel export command that is described in the PHP Interop chapter.

    <?php
return (new \Phel\Config\PhelConfig())
    ->setExport((new \Phel\Config\PhelExportConfig())
        ->setDirectories(['src/phel'])
        ->setNamespacePrefix('PhelGenerated')
        ->setTargetDirectory('src/PhelGenerated'))
    # ...
;

    Currently, the export command requires three options:

    • setDirectories: Sets a list of directories in which the export command should search for export functions.
    • setNamespacePrefix: Sets a namespace prefix for all generated PHP classes.
    • setTargetDirectory: Sets the directory where the generated PHP classes are stored.

    IgnoreWhenBuilding#

    Set a list of Phel files that should be ignored when building the code.

    <?php
return (new \Phel\Config\PhelConfig())
    ->setIgnoreWhenBuilding(['src/phel/local.phel'])
    # ...
;

    NoCacheWhenBuilding#

    • setNoCacheWhenBuilding(list<string>)

    Set a list of Phel files that should be not cached when building the code. This means, they will be transpiled all the time; regardless when you use the --cache or --no-cache flag.

    <?php
return (new \Phel\Config\PhelConfig())
    ->setNoCacheWhenBuilding(['src/phel/local.phel'])
    # ...
;

    FormatDirs#

    Set a list of directories whose files will be formatted when running the format command.

    <?php
return (new \Phel\Config\PhelConfig())
    ->setFormatDirs(['src', 'tests'])
    # ...
;

    KeepGeneratedTempFiles#

    A flag that automatically removes all generated temporal files once the command phel run has been executed. Default is false.

    <?php
return (new \Phel\Config\PhelConfig())
    ->setKeepGeneratedTempFiles(false)
    # ...
;