PHPackages                             rosalana/configure - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. rosalana/configure

ActiveLibrary[Utility & Helpers](/categories/utility)

rosalana/configure
==================

A Laravel package to manage application configuration settings.

v1.0.5(4mo ago)347[1 issues](https://github.com/rosalana/configure/issues)1MITPHPPHP ^8.2

Since Dec 19Pushed 4mo agoCompare

[ Source](https://github.com/rosalana/configure)[ Packagist](https://packagist.org/packages/rosalana/configure)[ RSS](/packages/rosalana-configure/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (4)Versions (7)Used By (1)

[![Rosalana](https://raw.githubusercontent.com/rosalana/.github/main/Configure_Banner.png)](https://github.com/rosalana)

**Rosalana Configure** is a low-level engine for **programmatic, structure-safe manipulation of Laravel configuration files.**

It allows you to **read, modify, generate and reorganize config files** while **preserving formatting, order, comments, and developer intent.**

This package is designed primarily for:

- Laravel **package authors**
- tooling and installers
- automated configuration workflows
- advanced configuration migrations

Installation
------------

[](#installation)

```
composer require rosalana/configure
```

Why Configure?
--------------

[](#why-configure)

Laravel configuration files are PHP code — not simple data structures.

Editing them reliably means dealing with:

- nested arrays
- comments
- formatting
- ordering
- developer edits
- partial updates

**Rosalana Configure does not treat config files as arrays.**It treats them as a **structured document** composed of nodes.

Note

Think of it more like a DOM or AST for Laravel config files.

Core Concepts
-------------

[](#core-concepts)

### Nodes

[](#nodes)

Every configuration file is represented as a **tree of nodes:**

Node TypeDescription`File`Root of the configuration file`Section`An array block (`'database' => [...]`)`Value`A single key-value pair`Comment`Single-line comment (`//`)`RichComment`Laravel-style block comment (`/* */`)All operations are performed **by selecting nodes**, not by mutating arrays.

---

### Selection Model

[](#selection-model)

Selection works similarly to **browser dev tools:**

- You select a node
- Operate on it
- Scope moves automatically to make chaining intuitive

```
use Rosalana\Configure\Configure;

$file = Configure::file('database');
```

---

### Sections vs Values

[](#sections-vs-values)

- **Sections** represent arrays
- **Values** represent scalar or expression values

```
$file->section('connections');
$file->value('default');
```

You can traverse deeper:

```
$file->section('connections')
          ->section('mysql')
               ->value('host');
```

Or jump directly using a full path:

```
$file->value('connections.mysql.host');
```

---

### Automatic Creation

[](#automatic-creation)

If a section or value does not exist, it is **created automatically.**

> New nodes are always appended to the end of their parent section.

```
$file->value('connections.mysql.host', 'localhost');
```

Working with Values
-------------------

[](#working-with-values)

```
$value = $file->value('connections.mysql.host');

$value->get();               // current value
$value->set('localhost');    // hard set
$value->add('localhost');    // soft set
$value->remove();            // delete value
```

### Soft assignment

[](#soft-assignment)

```
$file->value('connections.mysql.host', 'localhost');
```

Sets the value **only if it does not already exist.**

---

### Value typing

[](#value-typing)

Always pass values as **strings.**The engine resolves the correct PHP representation.

```
$value->set('3306');                         // int
$value->set('true');                         // bool
$value->set('null');                         // null
$value->set('My App');                       // string
$value->set("['a', 'b']");                   // array
$value->set("env('DB_HOST', 'localhost')");  // function
$value->set("User::class");                  // class constant
```

Non-associative arrays can be written on multiple lines and still be recognized correctly. **The engine will automatically reformat them when containing five items or more**.

Important

Associative arrays must be created using `section()`, not `set()`.

---

Renaming Nodes
--------------

[](#renaming-nodes)

Renaming changes the node path. When selecting again, use the new name.

```
$file->value('connections.mysql.host')
     ->rename('hostname');

$file->value('connections.mysql.hostname');
```

Moving and Reordering Nodes
---------------------------

[](#moving-and-reordering-nodes)

All nodes can be reordered **within their parent scope.**

```
$file->section('connections')->moveUp();
$file->section('connections')->moveDown();
$file->section('connections')->keepStart();
$file->section('connections')->keepEnd();
$file->section('connections')->before('redis');
$file->section('connections')->after('redis');
```

### Cross-scope movement

[](#cross-scope-movement)

To move nodes outside their parent, specify the full target path.

```
$file->section('connections')->cut('redis.options');
$file->section('connections')->copy('redis.options');
```

Chaining & Scope Control
----------------------------

[](#chaining--scope-control)

Selectors automatically return to the appropriate scope.

```
$file
    ->section('connections')
        ->value('default')->set('sqlite')
        ->section('mysql')
            ->value('host')->moveUp();
```

### Root selection (`.` notation)

[](#root-selection--notation)

Using `.` always resets scope to the root file.

```
$file
    ->section('connections')
        ->value('default', 'sqlite')
     ->section('.redis');

$file->value('connections.mysql.host');
```

Comments Support
----------------

[](#comments-support)

Comments are first-class citizens. You can add, remove, and manipulate comments in the same way as other nodes.

### Single-line comments

[](#single-line-comments)

```
$file->section('connections')
     ->comment('Database connections');
```

```
'connections' => [
    // Database connections
]
```

---

### Multi-line comments

[](#multi-line-comments)

```
$file->section('connections')
     ->comment("Line one\nLine two");
```

```
'connections' => [
    // Line one
    // Line two
]
```

---

### Laravel-style comments

[](#laravel-style-comments)

```
$file->section('connections')
     ->comment(
         'Database connections',
         "Used by the application\nDo not edit manually"
     );
```

```
'connections' => [

    /*
    |----------------------------------------------------
    | Database connections
    |----------------------------------------------------
    |
    | Used by the application
    | Do not edit manually
    |
    */

]
```

---

### Node-bound comments

[](#node-bound-comments)

As you can see, comments were placed **inside** the section they are created in just like other nodes.

Selecting comments can be tricky, because comments do not have keys.

More proper way to create and select comments is to bound them to other nodes. Every node may have **one associated comment, placed immediately above it.**

```
$file->section('connections')
     ->withComment('Main database configuration'); // rich comment

$file->value('default')
     ->withComment('Default connection'); // simple comment
```

Important

The comment is rewritten if the node already has an associated comment. Also note that `withComment()` is just for scoping convenience. It does not make any functional difference compared to creating comments normally.

This way, comments are logically tied to their nodes, and you can rewrite them without worrying about selecting them directly.

```
$file->section('connections')->withoutComment();
```

Layout, Padding & Formatting
--------------------------------

[](#layout-padding--formatting)

Each node defines its own **padding rules.**

The engine:

- respects indentation
- preserves spacing between nodes
- recalculates layout on every structural change
- guarantees consistent formatting

You never manually manage whitespace.

Saving & Diffing
--------------------

[](#saving--diffing)

### Save Changes

[](#save-changes)

```
$file->save();
```

### Preview Changes

[](#preview-changes)

```
$render = $file->render(); // array of lines
$diff = $file->diff();     // array-based diff
```

Debugging & Inspection
--------------------------

[](#debugging--inspection)

Every node can be inspected:

```
/**
 * Get the node array representation.
 * @return array
 */
$node->toArray();

/**
 * Get the type of the node.
 *
 * @return string 'file', 'section', 'value', 'comment', 'richcomment'
 */
$node->type();
```

---

### Common Getter Methods

[](#common-getter-methods)

```
/**
 * Get the node path.
 * @return string
 */
$node->path(): string;

/**
 * Get the node name.
 * @return string
 */
$node->name(): string;

/**
 * Get the node start line number.
 * @return int
 */
$node->start(): int;

/**
 * Get the node end line number.
 * @return int
 */
$node->end(): int;

/**
 * Get the node raw array of lines.
 * @return array
 */
$node->raw(): array;

/**
 * Render the node to array of lines.
 * @return array
 */
$node->render(): array;

/**
 * Get the node indentation level. (including padding)
 * @return int
 */
$node->scale(): int;

/**
 * Get the node parent instance.
 * @return ?ParentNode
 */
$node->parent(): ?ParentNode;

/**
 * Get the node siblings collection.
 * @return Collection
 */
$node->siblings(): Collection;

/**
 * Get the sibling nodes before the current node.
 * @return Collection
 */
$node->siblingsBefore(): Collection;

/**
 * Get the sibling nodes after the current node.
 * @return Collection
 */
$node->siblingsAfter(): : Collection;

/**
 * Get the root file instance.
 * @return File
 */
$node->root(): File;
```

---

### Common Helpers

[](#common-helpers)

```
/** Determine if the node was created during this session. */
$node->isNew(): bool;

/** Determine if the node has unsaved changes. */
$node->isDirty(): bool;

/** Determine if the node is of a specific type. */
$node->isTypeOf(string $type): bool;

/** Determine if the node is a sub-node (not top-level). */
$node->isSubNode(): bool;

/** Determine if the node is at root top-level. */
$node->isRoot(): bool;

/** Determine if the node is the first child of its parent. */
$node->isFirstChild(): bool;

/** Determine if the node is the last child of its parent. */
$node->isLastChild(): bool;
```

---

### Value Helpers

[](#value-helpers)

```
$value->isNull(): bool;
$value->isString(): bool;
$value->isNumber(): bool;
$value->isBoolean(): bool;
$value->isArray(): bool;
$value->isFunction(): bool;
$value->isClass(): bool;
```

---

### Parent Node Helpers

[](#parent-node-helpers)

```
$parent->nodes(): Collection;
```

---

### Comment Node Helpers

[](#comment-node-helpers)

```
$comment->label(): string;
$comment->setLabel(string $label): static;

// RichComment only
$comment->description(): string;
$comment->setDescription(string $body): static;
```

License
-------

[](#license)

Rosalana Configure is open-source under the [MIT license](/LICENCE), allowing you to freely use, modify, and distribute it with minimal restrictions.

You may not be able to use our systems but you can use our code to build your own.

For details on how to contribute or how the Rosalana ecosystem is maintained, please refer to each repository’s individual guidelines.

**Questions or feedback?**

Feel free to open an issue or contribute with a pull request. Happy coding with Rosalana!

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance71

Regular maintenance activity

Popularity13

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~14 days

Total

6

Last Release

123d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c9ccd4c922b657506198515445c7d0ece52b8261178e0490e7ba2a81ca78a915?d=identicon)[michalbany](/maintainers/michalbany)

---

Top Contributors

[![michaelbany](https://avatars.githubusercontent.com/u/117490667?v=4)](https://github.com/michaelbany "michaelbany (42 commits)")

---

Tags

laravelconfigrosalana

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/rosalana-configure/health.svg)

```
[![Health](https://phpackages.com/badges/rosalana-configure/health.svg)](https://phpackages.com/packages/rosalana-configure)
```

###  Alternatives

[illuminate/database

The Illuminate Database package.

2.8k54.9M11.6k](/packages/illuminate-database)[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[renatomarinho/laravel-page-speed

Laravel Page Speed

2.5k1.7M10](/packages/renatomarinho-laravel-page-speed)[vinkius-labs/laravel-page-speed

Laravel Page Speed

2.5k12.5k1](/packages/vinkius-labs-laravel-page-speed)[emargareten/inertia-modal

Inertia Modal is a Laravel package that lets you implement backend-driven modal dialogs for Inertia apps.

90142.9k](/packages/emargareten-inertia-modal)[wearepixel/laravel-cart

A cart implementation for Laravel

1374.8k](/packages/wearepixel-laravel-cart)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)