uploadcare/uploadcare-zend2

Official Uploadcare package for Zend Framework 2

Uploadcare Zend Framework 2 Module

This is a module for [Zend Framework 2][5] to work with Uploadcare, _(*1)

It's based on a uploadcare-php library., _(*2)

Requirements

• Zend 2.0+
• PHP 5.3+
• php-curl

Install

GitHub

Clone module from git to your vendor directory:, _(*3)

git clone git://github.com/uploadcare/uploadcare-zend2.git vendor/Uploadcare --recursive

Composer

Update your composer.json:, _(*4)

"require": {
  "uploadcare/uploadcare-zend2": "dev-master"
}   

Install package:, _(*5)

composer update

Fetch submodules from github:, _(*6)

cd vendor/uploadcare/uploadcare-zend2/ && git submodule init && git submodule update   

Edit your config/application.config.php and add new module. It should look like this:, _(*7)

return array(
    'modules' => array(
        'Application',
        'Uploadcare',
    ),
    'module_listener_options' => array(
        'config_glob_paths'    => array(
            'config/autoload/{,*.}{global,local}.php',
        ),
        'module_paths' => array(
            './module',
            './vendor',
        ),
    ),  

);, _(*8)

Inside your config/autoload/global.php add:, _(*9)

return array(
    'uploadcare' => array(
      'public_key' => 'demopublickey',
      'secret_key' => 'demoprivatekey',
    ),
);

Usage

You can access uploadcare api service inside a controller like this:, _(*10)

$uploadcare = $this->getServiceLocator()->get('uploadcare');

It will return a UploadcareZend object. This class extends Uploadcare\Api class., _(*11)

Create a from to show Uploadcare widget. Use UploadcareInput class as a field., _(*12)

Inside your controller:, _(*13)

namespace Application\Controller;

use Zend\Mvc\Controller\AbstractActionController;
use Uploadcare\Form\UploadcareInput;
use Zend\Form\Form;

class IndexController extends AbstractActionController
{
    public function indexAction()
    {
        $uploadcare = $this->getServiceLocator()->get('uploadcare');

        //file_id is name of input for widget. 
        //You will recieve File ID at CDN from this field.
        $uploadcare_widget = new UploadcareInput('file_id');

        $form = new Form();
        $form->add($uploadcare_widget);
        $form->add(array('name' => 'submit',
          'attributes' => array(
            'type'  => 'submit',
            'value' => 'Upload!'
        )));

        return array(
          'form' => $form,
          'uploadcare' => $uploadcare,
        );
    }
}

Now we can display a form with a widget inside view:, _(*14)

<?php
$this->form->prepare();

echo $this->uploadcare->widget->getScriptTag();
echo $this->form()->openTag($form);
echo $this->formCollection($form);
echo $this->form()->closeTag();

"echo $this->uploadcare->widget->getScriptTag();" will display all <script> sections you need., _(*15)

Now you are able to upload files using Uploadcare widget., _(*16)

Let's handle file_id and display the file. Update your controller to look like this:, _(*17)

class IndexController extends AbstractActionController
{
    public function indexAction()
    {
        $uploadcare = $this->getServiceLocator()->get('uploadcare');

        $uploadcare_widget = new UploadcareInput('file_id');

        $form = new Form();
        $form->add($uploadcare_widget);
        $form->add(array('name' => 'submit',
          'attributes' => array(
            'type'  => 'submit',
            'value' => 'Upload!'
        )));

        $file = null;
        $request = $this->getRequest();
        if ($request->isPost()) {
          $form->setData($request->getPost()->toArray());
          if ($form->isValid()) {
            $data = $form->getData();
            $file_id = $data['file_id'];
            $file = $uploadcare->getFile($file_id); //get file from API
            $file->store(); //store file
          }
        }

        return array(
          'form' => $form,
          'uploadcare' => $uploadcare,
          'file' => $file,
        );
    }
}

Now we have an object of Uploadcare\File. Let's display it inside view:, _(*18)

echo $this->file->scaleCrop(300, 300, true)->getImgTag();