PHPackages                             naffiq/rocket-tools - 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 &amp; Helpers](/categories/utility)
4. /
5. naffiq/rocket-tools

ActiveProject[Utility &amp; Helpers](/categories/utility)

naffiq/rocket-tools
===================

RocketFirm tools to jumpstart with development

v0.2.2(9y ago)131[1 issues](https://github.com/naffiq/rocket-tools/issues)MITPHP

Since May 25Pushed 9y ago1 watchersCompare

[ Source](https://github.com/naffiq/rocket-tools)[ Packagist](https://packagist.org/packages/naffiq/rocket-tools)[ RSS](/packages/naffiq-rocket-tools/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (6)Dependencies (3)Versions (7)Used By (0)

RocketTools
===========

[](#rockettools)

This little php script helps you generate and manage nginx configuration for your project.

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

[](#installation)

### Via composer

[](#via-composer)

Install this project globally by running

```
$ composer global require naffiq/rocket-tools
```

Make sure, that you have your composer's `bin` directory linked to your `PATH` environment variable.

### Download PHAR executable

[](#download-phar-executable)

You can get the latest version this utility on [releases page](https://github.com/naffiq/rocket-tools/releases/latest). Just grab `rocket-tools.phar` and put it to your `/usr/local/bin` directory (if you're on macOS/Linux) or just any folder listed in your `PATH` on Windows.

Usage
-----

[](#usage)

Check the version by running

```
$ rocket-tools --version
```

### Generate nginx configurations

[](#generate-nginx-configurations)

You can create nginx config in sites-available for your Yii2 project (basic for now) by running

```
$ rocket-tools nginx:generate  [] [] [] [] []
```

This command takes following arguments:

- `server-name` Domain (server\_name) for newly created app
- `config-name` File name for your config file. If not set first `server-name` is used
- `document-root` Document root for your project. If not set, taken from run directory. **default: "CURRENT/RUNNING/DIRECTORY"**
- `sites-available` Path of sites-available folder **default: "/etc/nginx/sites-available"**
- `port` Listen port. **default: 80**
- `fast-cgi-pass` Fast CGI pass. **default: "unix:/var/run/php7.1-fpm.sock"**

You can override defaults by configuring `rocket-tools` with \[config:update\](#Configuring RocketTools) command.

### Link/unlink nginx sites available

[](#linkunlink-nginx-sites-available)

Run this command to link config from `sites-available` to `sites-enabled` folder:

```
$ rocket-tools nginx:link  [] []
```

Arguments:

- `site-name` Configuration file name
- `sites-available` Sites available directory (without .conf) **default: "/etc/nginx/sites-available"**
- `sites-enabled` Sites enabled directory **default: "/etc/nginx/sites-enabled"**

To unlink config run:

```
$ rocket-tools nginx:unlink  []
```

Arguments:

- `site-name` Configuration file name
- `sites-enabled` Sites enabled directory **default: "/etc/nginx/sites-enabled"**

You can override defaults by configuring `rocket-tools` with \[config:update\](#Configuring RocketTools) command.

### Configuring RocketTools

[](#configuring-rockettools)

To override default configurations run:

```
$ config:update
$ config:set

```

Arguments:

- `config-name` Configuration key
- `config-value` Configuration value

So in order to override `nginx:generate` configurations simply take it's argument (for example `sites-available`), add `nginx-` prefix to it and use it as configuration key. The only exception is `fast-cgi-pass`, which is related to `php-fpm` and hand

**Example:**

```
$ config:update nginx-sites-available /usr/local/etc/nginx/sites-available
```

There is also a command for viewing your current configuration:

```
$ config:get []
```

Arguments:

- `config-name` Configuration key. If not set, displays all config values.

#### Configuration files

[](#configuration-files)

All of the configuration files are stored in `$HOME/.rocket-tools/` directory. If you want to change it, set `ROCKET_TOOLS_HOME` environment variable to desired path.

### Updating RocketTools

[](#updating-rockettools)

If you are using `composer` run:

```
$ composer global update naffiq/rocket-tools
```

Just like `composer.phar`, `rocket-tools.phar` file contains `self-update` command, if you manually downloaded it from releases page.

#### Under the hood:

[](#under-the-hood)

- [Symfony Console](https://github.com/symfony/console)
- [box-project/box2](https://github.com/box-project/box2/)
- [humbug/phar-updater](https://github.com/humbug/phar-updater)

#### TODO:

[](#todo)

- Add default templates for nginx configs (Yii2 advanced, Laravel, Symfony)
- Custom templates for nginx config
- Apache2 config generator
- Automated MySQL DB/User creation
- Automated `.env` file generator
- hosts file editor
- All of the steps in one command master

### License: MIT

[](#license-mit)

> Crafted with ♥

###  Health Score

21

—

LowBetter than 18% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity57

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 ~0 days

Total

6

Last Release

3322d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3990098?v=4)[Galymzhan Abdugalimov](/maintainers/naffiq)[@naffiq](https://github.com/naffiq)

---

Top Contributors

[![naffiq](https://avatars.githubusercontent.com/u/3990098?v=4)](https://github.com/naffiq "naffiq (25 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/naffiq-rocket-tools/health.svg)

```
[![Health](https://phpackages.com/badges/naffiq-rocket-tools/health.svg)](https://phpackages.com/packages/naffiq-rocket-tools)
```

###  Alternatives

[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

101466.4k45](/packages/friendsoftypo3-content-blocks)[php-soap/wsdl

Deals with WSDLs

183.8M18](/packages/php-soap-wsdl)[phel-lang/phel-lang

Phel is a functional programming language that compiles to PHP

5155.1k17](/packages/phel-lang-phel-lang)

PHPackages © 2026

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