Ht-manager

Ht-manager is an interactive cli tool to simplify management of htpasswd and htgroup files.

This tool is written in PHP 8 and uses the classes of

• https://github.com/axelhahn/php-htpasswd

---

👤 Author: Axel Hahn
🧾 Source: https://github.com/axelhahn/ht-manager/
📜 License: GNU GPL 3.0

Screenshot

For PHP developers: Use php script

You can use the php script directly if you have a php interpreter installed. Just run php src/htman.php.

BUT: You cannot move the script around - it includes a few files from vendor directory.

Use merged php script or binary

The sources can be compiled into a single file.

• a single php script and
• a binary using SPC

Check the releases page https://github.com/axelhahn/ht-manager/releases/ to get the merged script or pre compiled file.

Copy the php script or binary to /usr/bin or ~/bin/ to start it witout path.

Or compile it yourself. See the next chapter.

Compile

src/htman.phpcan be compiled into a standalone binary with the delivered scripts by using SPC (check out https://static-php.dev/). This was tested on Linux.

A compiled binary is a single binary without dependencies. You can put onto a machine of the same architecture. On your targets no PHP is needed.

Requirements

Linux packages

• git
• wget
• elfpatch

Compile

Start once

Start ./compile/installer.php to download the SPC binary and let it generate needed files and Micro sfx. This compilation takes some minutes.

As long you dont't want to set another php version or include an additional php module you don't need to repeat this step.

Compile binary

Run ./compile/build.php to merge changes in src/htman.php into a newly generated binary. This is done within a second.

Output files on Linux:

Merged php file:
- ./built_packages/htman.php

Compiled binay:
- ./built_packages/htman
- ./built_packages/htman_linux_x86_64
- ./built_packages/htman_linux_x86_64__README.md

Usage

Copy built_packages/htman into a bin directory eg /usr/bin/ or ~/bin/ (or create a softlink) to start it without path on any system without PHP installed. On Systems with PHP you can deploy built_packages/htman.php as single script. This is a merged php script that includes all needed files.

Start htman for interactive mode.

Start htman -h to see supported parameters.

php src/htman.php -h
      _____________
_____/  A x e l s  \_________________________________________________

   _______ __                                                      
  |   |   |  |_ ______.--------.---.-.-----.---.-.-----.-----.----.
  |       |   _|______|        |  _  |     |  _  |  _  |  -__|   _|
  |___|___|____|      |__|__|__|___._|__|__|___._|___  |_____|__|  
                                                 |_____|      v0.5
  👤 Author: Axel Hahn
  🧾 Source: https://github.com/axelhahn/ht-manager/
  📜 License: GNU GPL 3.0

HELP:
Manage htpasswd and htgroups

PARAMETERS:
  -d
  --debug (without value)
    Debug mode.
    Show debug messages on actions.

  -f
  --folder [value] (value required)
    Folder name where to put .htpasswd an .htgroup
    Set a folder where to handle the .htpasswd and .htgroup files.
    If a value is given then it will be checked against regex /./i

  -h
  --help (without value)
    Show help and exit

  -v
  --version (without value)
    Show version and exit