ndoulgeridis/smb-bundle

Samba client for Symfony3

Installs: 199

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 2

Forks: 3

Type:symfony-bundle

0.2.0 2018-08-21 20:17 UTC

This package is not auto-updated.

Last update: 2024-11-07 23:41:11 UTC


README

SMB-Bundle

PHP wrapper for smbclient and libsmbclient-php

  • Reuses a single smbclient instance for multiple requests
  • Doesn't leak the password to the process list
  • Simple 1-on-1 mapping of SMB commands
  • A stream-based api to remove the need for temporary files
  • Support for using libsmbclient directly trough libsmbclient-php

Installation

  1. Add as a dependency in your composer file

    "require": {
        "ndoulgeridis/smb-bundle":"dev-master"
    }
  2. Add to your Kernel

    // application/ApplicationKernel.php
    public function registerBundles()
    {
        $bundles = array(
            new SMBBundle\SMBBundle()
        );
     }
  3. (optional) Adjust configurations

    # application/config/config.yml
    smb:
        host: localhost
        user: test
        password: test

Examples

Upload a file

<?php

$fileToUpload = __FILE__;

$server = $this->get('smb.server');
$share = $server->getShare('test');
$share->put($fileToUpload, 'example.txt');

Download a file

<?php
$target = __DIR__ . '/target.txt';

$server = $this->get('smb.server');
$share = $server->getShare('test');
$share->get('example.txt', $target);

List shares on the remote server

<?php

$server = $this->get('smb.server');
$shares = $server->listShares();

foreach ($shares as $share) {
	echo $share->getName() . "\n";
}

List the content of a folder

<?php

$server = $this->get('smb.server');
$share = $server->getShare('test');
$content = $share->dir('test');

foreach ($content as $info) {
	echo $name->getName() . "\n";
	echo "\tsize :" . $info->getSize() . "\n";
}

Using read streams

<?php

$server = $this->get('smb.server');
$share = $server->getShare('test');

$fh = $share->read('test.txt');
echo fread($fh, 4086);
fclose($fh);

Using write streams

<?php

$server = $this->get('smb.server');
$share = $server->getShare('test');

$fh = $share->write('test.txt');
fwrite($fh, 'bar');
fclose($fh);

Using other configurations

<?php

$server = $this->get('smb.server');
$server->setAuthParams('localhost', 'user0', 'user0');
$share = $server->getShare('test');

Using libsmbclient-php

Install libsmbclient-php

<?php

$fileToUpload = __FILE__;

if (Server::NativeAvailable()) {
    $server = new NativeServer('localhost', 'test', 'test');
} else {
    echo 'libsmbclient-php not available, falling back to wrapping smbclient';
    $server = $server = $this->get('smb.server');;
}
$share = $server->getShare('test');
$share->put($fileToUpload, 'example.txt');