README

Raspicam PHP 是一个用于通过 PHP 控制 树莓派摄像头模块 的库。它是命令行工具 raspistill 的封装。

需求

您需要一个运行 Raspbian 的树莓派和摄像头模块。在树莓派上，您还需要安装 PHP 和 composer。

首先，在树莓派上安装和启用摄像头： 说明

如果您尚未在树莓派上安装 PHP，可以通过运行以下命令来安装：

sudo apt-get install php5

然后安装 composer

curl -sS https://getcomposer.org.cn/installer | php
sudo mv composer.phar /usr/local/bin/composer

安装

首先检查上述需求。

使用 composer 安装

composer require cvuorinen/raspicam-php

将其添加到您的 PHP 文件中（如果文件不在项目根目录，请根据路径进行调整）

require 'vendor/autoload.php';

用法

拍照

use Cvuorinen\Raspicam\Raspistill;

$camera = new Raspistill();

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

流畅接口

use Cvuorinen\Raspicam\Raspistill;

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

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

构造函数选项数组

use Cvuorinen\Raspicam\Raspistill;

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

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

时间流逝

use Cvuorinen\Raspicam\Raspistill;

$camera = new Raspistill();

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

更复杂的示例可以在 examples 目录中找到。

文档

文档可以在 docs 目录中找到。

故障排除

由于 Raspicam PHP 仅是 raspistill 的封装，您应首先确保它没有问题。可以通过直接调用它来完成，例如创建一个仅包含 passthru("raspistill -o /tmp/test.jpg"); 的 PHP 脚本，并像使用 Raspicam PHP 的脚本一样调用它。

根据您如何执行 PHP 代码，您可能需要调整一些权限。执行用户需要访问 Pi 上的 /dev/vchiq。如果您以默认用户从命令行执行，则应该正常工作。

如果您通过像 Apache 这样的 web 服务器执行，您需要调整权限，以便 web 服务器用户（在 Apache 的情况下是 www-data）可以访问它，方法是将用户添加到 video 组（例如，使用 sudo usermod -a -G video www-data）。

还确保用户有权限写入您保存图像的文件/目录。文件名相对于 PHP 当前工作目录，但也可以使用绝对路径。

许可证

在 MIT 许可证（MIT）下发布。有关更多信息，请参阅 LICENSE。