The goal is to easily archive generated PDF documents from one location (the "local" location) to another location (the "remote" one).
Let's say we have a local architecture like this:
company/
├── first-folder
│ ├── makefile
│ ├── document.tex
│ ├── pdf
│ │ └── document.pdf
│ └── report
│ ├── makefile
│ ├── report.tex
│ └── pdf
│ └── report.pdf
├── second-folder
│ ├── makefile
│ ├── reporting.tex
│ └── pdf
│ └── reporting.pdf
└── dummy
We will transfer PDF files to the remote filesystem with this architecture:
company/
├── first-folder
│ ├── document.pdf
│ └── report
│ ├── report.pdf
├── second-folder
│ ├── reporting.pdf
You don't need to create sub directories on the remote filesytem, they will automatically be created when copying PDF files to the remote filesystem.
PHP 5.4+ or HHVM 3.2+, and Composer are required.
To get the latest version of PdfArchiver, just run the following command from your Terminal:
$ composer require antoineaugusti/pdfarchiverAnd then pull the dependencies with the following command:
$ composer installPdfArchiver relies on the awesome Flysystem package from The PHP League. A lot of adapters are available in the documentation. Determine which adapters you'll need for your local and remote filesystems and then let the Antoineaugusti\PdfArchiver\Console\MoverCommand class do the work for you.
For example, let's say you want to move generated PDFs from your local machine to a SFTP server. An example is given here.
Steal the example file and place it at the root of this directory. Replace configuration values with your needs and you're good to go.
Don't forget to add dependencies for your adapters in your composer.json file and then run composer update.
commands is the file placed at the root of this directory where you have previously wired your adapters to the MoverCommand class.
Once you've chosen the right adapters (don't forget to pull dependencies with composer update) and you've set your configuration values, it will be very easy. The Antoineaugusti\PdfArchiver\Console\MoverCommand class will search recursively from the root folder you have defined in your local adapter with the following command:
$ php commands archiveIf you don't want to start at the defined root folder, but somewhere else, just give the relative path as the first argument:
$ php commands archive example/subfolderSince we are relying on the existence of a makefile and pdf folder, you may want to generate your PDF files before moving them to a remote location. Just pass the option --make when calling the script:
$ php commands archive example/subfolder --makeContributions are very welcome. This package is pretty simple right now and it only suits my needs. Feel free to open a PR to add some options or additional behavior!