Download the PHP package hichemtab-tech/namecrement without Composer
On this page you can find all versions of the php package hichemtab-tech/namecrement. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download hichemtab-tech/namecrement
More information about hichemtab-tech/namecrement
Files in hichemtab-tech/namecrement
Package namecrement
Short Description A smart php utility that generates unique incremental names, preventing naming collisions by automatically appending incremental suffixes.
License MIT
Informations about the package namecrement
Namecrement (PHP)
 [](https://github.com/HichemTab-tech/Namecrement-php/blob/master/LICENSE) 
Smart unique name generator for PHP
Automatically generates a unique name by incrementing it if needed — just like "file" → "file (1)" → "file (2)" and so on.
✨ Features
- Generate unique names based on existing ones
- Smart gap detection (fills missing indexes first)
- Lightweight, dependency-free
- Perfect for filenames, labels, IDs, and more
📦 Also Available
- JavaScript: Namecrement
- Python: Namecrement-py
📦 Installation
🚀 Usage
🧠 Advanced Usage
You can customize the suffix format using the %N% placeholder to define how the number is added:
🛡 Suffix Format Rules
- The
suffixFormatmust include%N%, or anInvalidArgumentExceptionwill be thrown. %N%will be replaced by the next available number.- Default format is
" (%N%)".
| Format Example | Result |
|---|---|
" (%N%)" |
file (1) |
-%N% |
file-1 |
_<v%N%> |
file_<v1> |
_%N%_ |
file_1_ |
📚 API
namecrement(string $baseName, array $existingNames): string
| Parameter | Type | Description |
|---|---|---|
baseName |
string | Proposed name to start from |
existingNames |
string[] | List of already existing names |
suffixFormat |
string | Optional format for suffix (optional) |
startingNumber |
int \| null |
The starting number for incrementing (default: null) |
Returns the next available unique name.
🛠 Examples
📄 License
This project is open-source and available under the MIT license.
🤝 Contributing
Contributions are welcome!
Please check out the CONTRIBUTING.md for guidelines.