TorControl is a PHP library to control a Tor server.
- Connect to a Tor server through network socket, SSL network socket or UNIX socket
- Support null, password and cookie file authentication methods
- Automatic authentication for null and cookie file methods
- Multi-line replies
- Unit-tested with PHPUnit
- Installation with Composer
Note: if you use the Symfony framework, you should use DunglasTorControlBundle.
If not already done, install Composer.
Add php-torcontrol to your composer.json:
composer require dunglas/php-torcontrol
<?php // Autoloading using composer require 'vendor/autoload.php'; // Connect to the TOR server using password authentication $tc = new TorControl\TorControl( array( 'hostname' => 'localhost', 'port' => 9051, 'password' => 'MySecr3tPassw0rd', 'authmethod' => 1 ) ); $tc->connect(); $tc->authenticate(); // Renew identity $res = $tc->executeCommand('SIGNAL NEWNYM'); // Echo the server reply code and message echo $res[0]['code'].': '.$res[0]['message']; // Quit $tc->quit();
PHP TorControl has been created by Kévin Dunglas.