Raspicam PHP

Raspicam PHP is a library to control the Raspberry Pi Camera Module with PHP. It is a wrapper around the command line tool raspistill.

Requirements

You need a Raspberry Pi running Raspbian and the Camera Module. On the Raspberry Pi you also need to have PHP and composer installed.

First, install and enable the Camera on the Raspberry Pi: Instructions

If you don't have PHP installed on the Raspberry Pi yet, you can install it by running:

sudo apt-get install php5

Then install composer:

curl -sS https://getcomposer.org/installer | php

Install

First check requirements above.

Install with composer:

composer require cvuorinen/raspicam-php

Add to your php file (adjust path accordingly if file not in project root):

require 'vendor/autoload.php';

Usage

Take picture

use Cvuorinen\Raspicam\Raspistill;

$camera = new Raspistill();

$camera->takePicture('pic.jpg');

Fluent interface

use Cvuorinen\Raspicam\Raspistill;

$camera = new Raspistill();
$camera->timeout(1)
    ->rotate(90)
    ->exposure(Raspistill::EXPOSURE_NIGHT)
    ->quality(85);

$camera->takePicture('pic.jpg');

Constructor options array

use Cvuorinen\Raspicam\Raspistill;

$camera = new Raspistill([
    'timeout' => 1,
    'rotate' => 90,
    'exposure' => Raspistill::EXPOSURE_NIGHT,
    'quality' => 85,
]);

$camera->takePicture('pic.jpg');

Timelapse

use Cvuorinen\Raspicam\Raspistill;

$camera = new Raspistill();

// take picture every ten seconds for two minutes
$camera->startTimelapse('image%04d.jpg', 10, 120);

More complex examples can be found in the examples directory.

Documentation

Documentation can be found in the the docs directory.

License

Released under the MIT License (MIT). See LICENSE for more information.

wdmtech / raspicam-php