exportcsv.class.php

Go to the documentation of this file.

<?php
/* Copyright (C) 2006-2013 Laurent Destailleur  <eldy@users.sourceforge.net>
 * 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/>.
 */
 
require_once DOL_DOCUMENT_ROOT.'/core/modules/export/modules_export.php';
 
// avoid timeout for big export
set_time_limit(0);
 
class ExportCsv extends ModeleExports
{
  public $label;
 
  public $extension;
 
  public $version = 'dolibarr';
 
  public $label_lib;
 
  public $version_lib;
 
  public $separator;
 
  public $handle; // Handle fichier
 
  public function getDriverId()
  {
    return $this->id;
  }
 
  public function getDriverLabel()
  {
    return $this->label;
  }
 
  public function getDriverDesc()
  {
    return $this->desc;
  }
 
  public function getDriverExtension()
  {
    return $this->extension;
  }
 
  public function getDriverVersion()
  {
    return $this->version;
  }
 
  public function getLibLabel()
  {
    return $this->label_lib;
  }
 
  public function getLibVersion()
  {
    return $this->version_lib;
  }
 
 
  // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
  public function open_file($file, $outputlangs)
  {
    // phpcs:enable
    global $langs;
 
    dol_syslog("ExportCsv::open_file file=".$file);
 
    $ret = 1;
 
    $outputlangs->load("exports");
    $this->handle = fopen($file, "wt");
    if (!$this->handle) {
      $langs->load("errors");
      $this->error = $langs->trans("ErrorFailToCreateFile", $file);
      $ret = -1;
    }
 
    return $ret;
  }
 
  // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
  public function write_header($outputlangs)
  {
    // phpcs:enable
    return 0;
  }
 
 
  // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
  public function write_title($array_export_fields_label, $array_selected_sorted, $outputlangs, $array_types)
  {
    // phpcs:enable
    $selectlabel = array();
    foreach ($array_selected_sorted as $code => $value) {
      if (strpos($code, ' as ') == 0) {
        $alias = str_replace(array('.', '-', '(', ')'), '_', $code);
      } else {
        $alias = substr($code, strpos($code, ' as ') + 4);
      }
      if (empty($alias)) {
        dol_syslog('Bad value for field with code='.$code.'. Try to redefine export.', LOG_WARNING);
        continue;
      }
 
      $newvalue = $array_export_fields_label[$code];
      if ($newvalue) {
        $newvalue = $outputlangs->transnoentitiesnoconv($newvalue);
      }
 
      // Label may be stored HTML encoded (for example extrafield labels saved through Translate::trans()),
      // so decode entities and remove HTML to keep the header consistent with the data cells.
      $newvalue = dol_string_nohtmltag($newvalue);
      $decodedlabel = $newvalue;
 
      // Clean data and add encloser if required (depending on value of USE_STRICT_CSV_RULES)
      include_once DOL_DOCUMENT_ROOT.'/core/lib/functions2.lib.php';
      $newvalue = csvClean($newvalue, getDolGlobalString('EXPORT_CSV_FORCE_CHARSET'), $this->separator);
 
      fwrite($this->handle, $newvalue.$this->separator);
      $typefield = isset($array_types[$code]) ? $array_types[$code] : '';
 
      if (preg_match('/^Select:/i', $typefield) && $typefield = substr($typefield, 7)) {
        // Append the "_label" suffix before cleaning so the derived column stays valid CSV
        // even when the decoded label contains the separator or a quote.
        $selectlabel[$code."_label"] = csvClean($decodedlabel."_label", $outputlangs->charset_output, $this->separator);
      }
    }
 
    foreach ($selectlabel as $key => $value) {
      fwrite($this->handle, $value.$this->separator);
    }
    fwrite($this->handle, "\n");
    return 0;
  }
 
 
  // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
  public function write_record($array_selected_sorted, $objp, $outputlangs, $array_types)
  {
    // phpcs:enable
 
    $outputlangs->charset_output = getDolGlobalString('EXPORT_CSV_FORCE_CHARSET');
 
    $this->col = 0;
 
    $reg = array();
    $selectlabelvalues = array();
    foreach ($array_selected_sorted as $code => $value) {
      if (strpos($code, ' as ') == 0) {
        $alias = str_replace(array('.', '-', '(', ')'), '_', $code);
      } else {
        $alias = substr($code, strpos($code, ' as ') + 4);
      }
      if (empty($alias)) {
        dol_syslog('Bad value for field with code='.$code.'. Try to redefine export.', LOG_WARNING);
        continue;
      }
 
      $newvalue = $objp->$alias;
      $typefield = isset($array_types[$code]) ? $array_types[$code] : '';
 
      // Translation newvalue
      if (preg_match('/^\‍((.*)\‍)$/i', $newvalue, $reg)) {
        $newvalue = $outputlangs->transnoentities($reg[1]);
      }
 
      // Clean data and add encloser if required (depending on value of USE_STRICT_CSV_RULES)
      include_once DOL_DOCUMENT_ROOT.'/core/lib/functions2.lib.php';
      $newvalue = csvClean($newvalue, $outputlangs->charset_output, $this->separator);
 
      if (preg_match('/^Select:/i', $typefield) && $typefield = substr($typefield, 7)) {
        $array = jsonOrUnserialize($typefield);
        if (is_array($array) && !empty($newvalue)) {
          $array = $array['options'];
          $selectlabelvalues[$code."_label"] = $array[$newvalue];
        } else {
          $selectlabelvalues[$code."_label"] = "";
        }
      }
 
      fwrite($this->handle, $newvalue.$this->separator);
      $this->col++;
    }
    foreach ($selectlabelvalues as $key => $value) {
      fwrite($this->handle, $value.$this->separator);
      $this->col++;
    }
 
    fwrite($this->handle, "\n");
    return 0;
  }
 
  // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
  public function write_footer($outputlangs)
  {
    // phpcs:enable
    return 0;
  }
 
  // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
  public function close_file()
  {
    // phpcs:enable
    fclose($this->handle);
    return 0;
  }
}