rebuild_merge_pdf.php

Go to the documentation of this file.

#!/usr/bin/env php
<?php
/*
 * Copyright (C) 2009-2012 Laurent Destailleur <eldy@users.sourceforge.net>
 * Copyright (C) 2024   Frédéric France     <frederic.france@free.fr>
 * Copyright (C) 2024-2025  MDW         <mdeweerd@users.noreply.github.com>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program. If not, see <https://www.gnu.org/licenses/>.
 */
 
if (!defined('NOSESSION')) {
  define('NOSESSION', '1');
}
 
$sapi_type = php_sapi_name();
$script_file = basename(__FILE__);
$path = __DIR__.'/';
 
// Test if batch mode
if (substr($sapi_type, 0, 3) == 'cgi') {
  echo "Error: You are using PHP for CGI. To execute ".$script_file." from command line, you must use PHP for CLI mode.\n";
  exit(1);
}
 
// Include Dolibarr environment
require_once $path."../../htdocs/master.inc.php";
require_once DOL_DOCUMENT_ROOT.'/core/lib/functionscli.lib.php';
// After this $db is an opened handler to database. We close it at end of file.
require_once DOL_DOCUMENT_ROOT."/core/lib/date.lib.php";
require_once DOL_DOCUMENT_ROOT.'/core/lib/invoice2.lib.php';
 
// Load main language strings
$langs->load("main");
 
// Global variables
$version = DOL_VERSION;
$error = 0;
 
$hookmanager->initHooks(array('cli'));
 
 
/*
 * Main
 */
 
@set_time_limit(0);
print "***** ".$script_file." (".$version.") pid=".dol_getmypid()." *****\n";
dol_syslog($script_file." launched with arg ".implode(',', $argv));
 
// Check parameters
if (!isset($argv[1])) {
  rebuild_merge_pdf_usage();
  exit(1);
}
 
if (!empty($dolibarr_main_db_readonly)) {
  print "Error: instance in read-onyl mode\n";
  exit(1);
}
 
 
$newlangid = 'en_EN'; // To force a new lang id
$filter = array();
$regenerate = ''; // Ask regenerate (contains name of model to use)
$option = '';
$fileprefix = 'mergedpdf';
$nomerge = 0;
$mode = 'invoice';
 
$dateafterdate = '';
$datebeforedate = '';
$paymentdateafter = '';
$paymentdatebefore = '';
$paymentonbankid = 0;
$thirdpartiesid = array();
 
foreach ($argv as $key => $value) {
  $found = false;
 
  // Define options
  if (preg_match('/^lang=/i', $value)) {
    $found = true;
    $valarray = explode('=', $value);
    $newlangid = $valarray[1];
    print 'Use language '.$newlangid.".\n";
  }
  if (preg_match('/^prefix=/i', $value)) {
    $found = true;
    $valarray = explode('=', $value);
    $fileprefix = $valarray[1];
    print 'Use prefix for filename '.$fileprefix.".\n";
  }
 
  if (preg_match('/^mode=/i', $value)) {
    $found = true;
    $valarray = explode('=', $value);
    $mode = $valarray[1];
    print 'Use mode '.$fileprefix.".\n";
  }
 
  $reg = array();
  if (preg_match('/^regenerate=(.*)/i', $value, $reg)) {
    if (!in_array($reg[1], array('', '0', 'no'))) {
      $found = true;
      $regenerate = $reg[1];
      print 'Regeneration of PDF is requested with template '.$regenerate."\n";
    }
  }
  if (preg_match('/^regeneratenomerge=(.*)/i', $value, $reg)) {
    if (!in_array($reg[1], array('', '0', 'no'))) {
      $found = true;
      $regenerate = $reg[1];
      $nomerge = 1;
      print 'Regeneration (without merge) of PDF is requested with template '.$regenerate."\n";
    }
  }
 
  if ($value == 'filter=all') {
    $found = true;
    $option .= (empty($option) ? '' : '_').'all';
    $filter[] = 'all';
 
    print 'Rebuild PDF for all invoices'."\n";
  }
 
  if ($value == 'filter=date') {
    $found = true;
    $option .= (empty($option) ? '' : '_').'date_'.$argv[$key + 1].'_'.$argv[$key + 2];
    $filter[] = 'date';
 
    $dateafterdate = dol_stringtotime($argv[$key + 1]);
    $datebeforedate = dol_stringtotime($argv[$key + 2]);
    print 'Rebuild PDF for documents validated between '.dol_print_date($dateafterdate, 'day', 'gmt')." and ".dol_print_date($datebeforedate, 'day', 'gmt').".\n";
  }
 
  if ($value == 'filter=payments') {
    $found = true;
    $option .= (empty($option) ? '' : '_').'payments_'.$argv[$key + 1].'_'.$argv[$key + 2];
    $filter[] = 'payments';
 
    $paymentdateafter = dol_stringtotime($argv[$key + 1].'000000');
    $paymentdatebefore = dol_stringtotime($argv[$key + 2].'235959');
    if (empty($paymentdateafter) || empty($paymentdatebefore)) {
      print 'Error: Bad date format or value'."\n";
      exit(1);
    }
    print 'Rebuild PDF for invoices with at least one payment between '.dol_print_date($paymentdateafter, 'day', 'gmt')." and ".dol_print_date($paymentdatebefore, 'day', 'gmt').".\n";
  }
 
  if ($value == 'filter=nopayment') {
    $found = true;
    $option .= (empty($option) ? '' : '_').'nopayment';
    $filter[] = 'nopayment';
 
    print 'Rebuild PDF for ivoices with no payment done yet.'."\n";
  }
 
  if ($value == 'filter=bank') {
    $found = true;
    $option .= (empty($option) ? '' : '_').'bank_'.$argv[$key + 1];
    $filter[] = 'bank';
 
    $paymentonbankref = $argv[$key + 1];
    $bankaccount = new Account($db);
    $result = $bankaccount->fetch(0, $paymentonbankref);
    if ($result <= 0) {
      print 'Error: Bank account with ref "'.$paymentonbankref.'" not found'."\n";
      exit(1);
    }
    $paymentonbankid = $bankaccount->id;
    print 'Rebuild PDF for invoices with at least one payment on financial account '.$bankaccount->ref."\n";
  }
 
  if ($value == 'filter=nodeposit') {
    $found = true;
    $option .= (empty($option) ? '' : '_').'nodeposit';
    $filter[] = 'nodeposit';
 
    print 'Exclude deposit invoices'."\n";
  }
  if ($value == 'filter=noreplacement') {
    $found = true;
    $option .= (empty($option) ? '' : '_').'noreplacement';
    $filter[] = 'noreplacement';
 
    print 'Exclude replacement invoices'."\n";
  }
  if ($value == 'filter=nocreditnote') {
    $found = true;
    $option .= (empty($option) ? '' : '_').'nocreditnote';
    $filter[] = 'nocreditnote';
 
    print 'Exclude credit note invoices'."\n";
  }
 
  if ($value == 'filter=excludethirdparties') {
    $found = true;
    $filter[] = 'excludethirdparties';
 
    $thirdpartiesid = explode(',', $argv[$key + 1]);
    print 'Exclude thirdparties with id in list ('.implode(',', $thirdpartiesid).").\n";
 
    $option .= (empty($option) ? '' : '_').'excludethirdparties'.implode('-', $thirdpartiesid);
  }
  if ($value == 'filter=onlythirdparties') {
    $found = true;
    $filter[] = 'onlythirdparties';
 
    $thirdpartiesid = explode(',', $argv[$key + 1]);
    print 'Only thirdparties with id in list ('.implode(',', $thirdpartiesid).").\n";
 
    $option .= (empty($option) ? '' : '_').'onlythirdparty'.implode('-', $thirdpartiesid);
  }
 
  if (!$found && preg_match('/filter=/i', $value)) {
    rebuild_merge_pdf_usage();
    exit(1);
  }
 
  $thirdpartiesid = array_map('intval', $thirdpartiesid);
  '@phan-var-force int[] $thirdpartiesid';
}
 
// Check if an option and a filter has been provided
if (empty($option) && count($filter) <= 0) {
  rebuild_merge_pdf_usage();
  exit(1);
}
// Check if there is no incompatible choice
if (in_array('payments', $filter) && in_array('nopayment', $filter)) {
  rebuild_merge_pdf_usage();
  exit(1);
}
if (in_array('bank', $filter) && in_array('nopayment', $filter)) {
  rebuild_merge_pdf_usage();
  exit(1);
}
 
$diroutputpdf = 'auto';
 
// Define SQL and SQL request to select invoices
// Use $filter, $dateafterdate, datebeforedate, $paymentdateafter, $paymentdatebefore
$result = rebuild_merge_pdf($db, $langs, $conf, $diroutputpdf, $newlangid, $filter, $dateafterdate, $datebeforedate, $paymentdateafter, $paymentdatebefore, 1, $regenerate, $option, (string) $paymentonbankid, $thirdpartiesid, $fileprefix, $nomerge, $mode);
 
// -------------------- END OF YOUR CODE --------------------
 
if ($result >= 0) {
  $error = 0;
  print '--- end ok'."\n";
} else {
  $error = $result;
  print '--- end error code='.$error."\n";
}
 
$db->close();
 
exit($error);
 
function rebuild_merge_pdf_usage()
{
  global $script_file;
 
  print "Rebuild PDF files for some invoices/orders/proposals and/or merge PDF files into one.\n";
  print "\n";
  print "To build/merge PDF for all documents, use filter=all\n";
  print "Usage:   ".$script_file." mode=invoice filter=all\n";
  print "To build/merge PDF for documents in a date range:\n";
  print "Usage:   ".$script_file." mode=invoice filter=date dateafter datebefore\n";
  print "To build/merge PDF for invoices with at least one payment in a date range:\n";
  print "Usage:   ".$script_file." mode=invoice filter=payments dateafter datebefore\n";
  print "To build/merge PDF for invoices with at least one payment onto a bank account:\n";
  print "Usage:   ".$script_file." mode=invoice filter=bank bankref\n";
  print "To build/merge PDF for invoices with no payments, use filter=nopayment\n";
  print "Usage:   ".$script_file." mode=invoice filter=nopayment\n";
  print "To exclude credit notes, use filter=nocreditnote\n";
  print "To exclude replacement invoices, use filter=noreplacement\n";
  print "To exclude deposit invoices, use filter=nodeposit\n";
  print "To exclude some thirdparties, use filter=excludethirdparties id1,id2...\n";
  print "To limit to some thirdparties, use filter=onlythirdparties id1,id2...\n";
  print "\n";
  print "To regenerate existing PDF before merge, use regenerate=templatename\n";
  print "To regenerate existing PDF with no merge (regenerate only), use regeneratenomerge=templatename\n";
  print "To merge by reusing existing PDF (generation only for non already existing PDF), use regenerate=no or nothing\n";
  print "\n";
  print "To generate documents in a given language, use lang=xx_XX\n";
  print "To set prefix of generated file name, use prefix=myfileprefix\n";
  print "\n";
  print "Example: ".$script_file." mode=invoice filter=payments 20080101 20081231 lang=fr_FR regenerate=crabe\n";
  print "Example: ".$script_file." mode=invoice filter=all lang=en_US\n";
  print "\n";
  print "Note that some filters can be cumulated.\n";
}