646 lines
16 KiB
PHP
646 lines
16 KiB
PHP
<?php
|
|
/**
|
|
* Classes and functions for export data from LDAP
|
|
*
|
|
* These classes provide differnet export formats.
|
|
*
|
|
* @author The phpLDAPadmin development team
|
|
* @package phpLDAPadmin
|
|
* @see export.php and export_form.php
|
|
*/
|
|
|
|
/**
|
|
* Exporter Class
|
|
*
|
|
* This class serves as a top level exporter class, which will return
|
|
* the correct Export class.
|
|
*
|
|
* @package phpLDAPadmin
|
|
* @subpackage Export
|
|
*/
|
|
class Exporter {
|
|
# Server ID that the export is linked to
|
|
private $server_id;
|
|
# Exporter Type
|
|
private $template_id;
|
|
private $template;
|
|
|
|
public function __construct($server_id,$template_id) {
|
|
$this->server_id = $server_id;
|
|
$this->template_id = $template_id;
|
|
|
|
$this->accept();
|
|
}
|
|
|
|
public static function types() {
|
|
$type = array();
|
|
|
|
$details = ExportCSV::getType();
|
|
$type[$details['type']] = $details;
|
|
$details = ExportDSML::getType();
|
|
$type[$details['type']] = $details;
|
|
$details = ExportLDIF::getType();
|
|
$type[$details['type']] = $details;
|
|
$details = ExportVCARD::getType();
|
|
$type[$details['type']] = $details;
|
|
|
|
return $type;
|
|
}
|
|
|
|
private function accept() {
|
|
switch($this->template_id) {
|
|
case 'CSV':
|
|
$this->template = new ExportCSV();
|
|
break;
|
|
|
|
case 'DSML':
|
|
$this->template = new ExportDSML();
|
|
break;
|
|
|
|
case 'LDIF':
|
|
$this->template = new ExportLDIF();
|
|
break;
|
|
|
|
case 'VCARD':
|
|
$this->template = new ExportVCARD();
|
|
break;
|
|
|
|
default:
|
|
system_message(array(
|
|
'title'=>sprintf('%s %s',_('Unknown Export Type'),$this->template_id),
|
|
'body'=>_('phpLDAPadmin has not been configured for that export type'),
|
|
'type'=>'warn'),'index.php');
|
|
die();
|
|
}
|
|
|
|
$this->template->accept();
|
|
}
|
|
|
|
public function getTemplate() {
|
|
return $this->template;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Export Class
|
|
*
|
|
* This abstract classes provides all the common methods and variables for the
|
|
* custom export classes.
|
|
*
|
|
* @package phpLDAPadmin
|
|
* @subpackage Export
|
|
*/
|
|
abstract class Export {
|
|
# Line Break
|
|
protected $br;
|
|
# Compress the output
|
|
protected $compress;
|
|
# Export Results
|
|
protected $results;
|
|
protected $resultsdata;
|
|
protected $items = 0;
|
|
|
|
/**
|
|
* Return this LDAP Server object
|
|
*
|
|
* @return object DataStore Server
|
|
*/
|
|
protected function getServer() {
|
|
return $_SESSION[APPCONFIG]->getServer($this->getServerID());
|
|
}
|
|
|
|
/**
|
|
* Return the LDAP server ID
|
|
*
|
|
* @return The Server ID
|
|
*/
|
|
protected function getServerID() {
|
|
return get_request('server_id','REQUEST');
|
|
}
|
|
|
|
public function accept() {
|
|
$server = $this->getServer();
|
|
|
|
# Get the data to be exported
|
|
$query = array();
|
|
$base = get_request('dn','REQUEST');
|
|
$query['baseok'] = true;
|
|
$query['filter'] = get_request('filter','REQUEST',false,'objectclass=*');
|
|
$query['scope'] = get_request('scope','REQUEST',false,'base');
|
|
$query['deref'] = $_SESSION[APPCONFIG]->getValue('deref','export');
|
|
$query['size_limit'] = 0;
|
|
$attrs = get_request('attributes','REQUEST');
|
|
|
|
$attrs = preg_replace('/\s+/','',$attrs);
|
|
if ($attrs)
|
|
$query['attrs'] = explode(',',$attrs);
|
|
else
|
|
$query['attrs'] = array('*');
|
|
|
|
if (get_request('sys_attr')) {
|
|
if (! in_array('*',$query['attrs']))
|
|
array_push($query['attrs'],'*');
|
|
array_push($query['attrs'],'+');
|
|
}
|
|
|
|
if (! $base)
|
|
$bases = $server->getBaseDN();
|
|
else
|
|
$bases = array($base);
|
|
|
|
foreach ($bases as $base) {
|
|
$query['base'] = $base;
|
|
|
|
$time_start = utime();
|
|
$this->results[$base] = $server->query($query,null);
|
|
$time_end = utime();
|
|
|
|
usort($this->results[$base],'pla_compare_dns');
|
|
$this->resultsdata[$base]['time'] = round($time_end-$time_start,2);
|
|
|
|
# If no result, there is a something wrong
|
|
if (! $this->results[$base] && $server->getErrorNum(null))
|
|
system_message(array(
|
|
'title'=>_('Encountered an error while performing search.'),
|
|
'body'=>ldap_error_msg($server->getErrorMessage(null),$server->getErrorNum(null)),
|
|
'type'=>'error'));
|
|
|
|
$this->items += count($this->results[$base]);
|
|
}
|
|
|
|
$this->resultsdata['scope'] = $query['scope'];
|
|
$this->resultsdata['filter'] = $query['filter'];
|
|
$this->resultsdata['attrs'] = $query['attrs'];
|
|
|
|
# Other settings
|
|
switch (get_request('format','POST',false,'unix')) {
|
|
case 'win':
|
|
$this->br = "\r\n";
|
|
break;
|
|
|
|
case 'mac':
|
|
$this->br = "\r";
|
|
break;
|
|
|
|
case 'unix':
|
|
default:
|
|
$this->br = "\n";
|
|
}
|
|
|
|
if (get_request('compress','REQUEST') == 'on')
|
|
$this->compress = true;
|
|
}
|
|
|
|
public function isCompressed() {
|
|
return $this->compress;
|
|
}
|
|
|
|
protected function getHeader() {
|
|
$server = $this->getServer();
|
|
$type = $this->getType();
|
|
|
|
$output = '';
|
|
|
|
$output .= sprintf('# %s %s %s%s',$type['description'],_('for'),implode('|',array_keys($this->results)),$this->br);
|
|
$output .= sprintf('# %s: %s (%s)%s',_('Server'),$server->getName(),$server->getValue('server','host'),$this->br);
|
|
$output .= sprintf('# %s: %s%s',_('Search Scope'),$this->resultsdata['scope'],$this->br);
|
|
$output .= sprintf('# %s: %s%s',_('Search Filter'),$this->resultsdata['filter'],$this->br);
|
|
$output .= sprintf('# %s: %s%s',_('Total Entries'),$this->items,$this->br);
|
|
$output .= sprintf('#%s',$this->br);
|
|
$output .= sprintf('# Generated by %s (%s) on %s%s',app_name(),get_href('web'),date('F j, Y g:i a'),$this->br);
|
|
$output .= sprintf('# Version: %s%s',app_version(),$this->br);
|
|
|
|
$output .= $this->br;
|
|
|
|
return $output;
|
|
}
|
|
|
|
/**
|
|
* Helper method to check if the attribute value should be base 64 encoded.
|
|
*
|
|
* @param The string to check.
|
|
* @return boolean true if the string is safe ascii, false otherwise.
|
|
*/
|
|
protected function isSafeAscii($str) {
|
|
for ($i=0;$i<strlen($str);$i++)
|
|
if (ord($str{$i}) < 32 || ord($str{$i}) > 127)
|
|
return false;
|
|
|
|
return true;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Export entries to CSV
|
|
*
|
|
* @package phpLDAPadmin
|
|
* @subpackage Export
|
|
*/
|
|
class ExportCSV extends Export {
|
|
private $separator = ',';
|
|
private $qualifier = '"';
|
|
private $multivalue_separator = ' | ';
|
|
private $escapeCode = '"';
|
|
|
|
static public function getType() {
|
|
return array('type'=>'CSV','description' => 'CSV (Spreadsheet)','extension'=>'csv');
|
|
}
|
|
|
|
public function export() {
|
|
$server = $this->getServer();
|
|
|
|
/* Go thru and find all the attribute names first. This is needed, because, otherwise we have
|
|
* no idea as to which search attributes were actually populated with data */
|
|
$headers = array('dn');
|
|
$entries = array();
|
|
foreach ($this->results as $base => $results) {
|
|
foreach ($results as $dndetails) {
|
|
array_push($entries,$dndetails);
|
|
|
|
unset($dndetails['dn']);
|
|
foreach (array_keys($dndetails) as $key)
|
|
if (! in_array($key,$headers))
|
|
array_push($headers,$key);
|
|
|
|
}
|
|
}
|
|
|
|
$output = '';
|
|
$num_headers = count($headers);
|
|
|
|
# Print out the headers
|
|
for ($i=0; $i<$num_headers; $i++) {
|
|
$output .= sprintf('%s%s%s',$this->qualifier,$headers[$i],$this->qualifier);
|
|
|
|
if ($i < $num_headers-1)
|
|
$output .= $this->separator;
|
|
}
|
|
|
|
# Drop out our DN header.
|
|
array_shift($headers);
|
|
$num_headers--;
|
|
|
|
$output .= $this->br;
|
|
|
|
# Loop on every entry
|
|
foreach ($entries as $index => $entry) {
|
|
$dn = $entry['dn'];
|
|
unset($entry['dn']);
|
|
$output .= sprintf('%s%s%s%s',$this->qualifier,$this->LdapEscape($dn),$this->qualifier,$this->separator);
|
|
|
|
# Print the attributes
|
|
for ($j=0; $j<$num_headers; $j++) {
|
|
$attr = $headers[$j];
|
|
$output .= $this->qualifier;
|
|
|
|
if (array_key_exists($attr,$entry)) {
|
|
$binary_attribute = $server->isAttrBinary($attr) ? 1 : 0;
|
|
|
|
if (! is_array($entry[$attr]))
|
|
$attr_values = array($entry[$attr]);
|
|
else
|
|
$attr_values = $entry[$attr];
|
|
|
|
$num_attr_values = count($attr_values);
|
|
|
|
for ($i=0; $i<$num_attr_values; $i++) {
|
|
if ($binary_attribute)
|
|
$output .= base64_encode($attr_values[$i]);
|
|
else
|
|
$output .= $this->LdapEscape($attr_values[$i]);
|
|
|
|
if ($i < $num_attr_values-1)
|
|
$output .= $this->multivalue_separator;
|
|
}
|
|
}
|
|
|
|
$output .= $this->qualifier;
|
|
|
|
if ($j < $num_headers-1)
|
|
$output .= $this->separator;
|
|
}
|
|
|
|
$output .= $this->br;
|
|
}
|
|
|
|
if ($this->compress)
|
|
return gzencode($output);
|
|
else
|
|
return $output;
|
|
}
|
|
|
|
/**
|
|
* Function to escape data, where the qualifier happens to also
|
|
* be in the data.
|
|
* @param $var
|
|
* @return mixed
|
|
*/
|
|
private function LdapEscape ($var) {
|
|
return str_replace($this->qualifier,$this->escapeCode.$this->qualifier,$var);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Export entries to DSML v.1
|
|
*
|
|
* @package phpLDAPadmin
|
|
* @subpackage Export
|
|
*/
|
|
class ExportDSML extends Export {
|
|
static public function getType() {
|
|
return array('type'=>'DSML','description' => _('DSML V.1 Export'),'extension'=>'xml');
|
|
}
|
|
|
|
/**
|
|
* Export entries to DSML format
|
|
*/
|
|
public function export() {
|
|
$server = $this->getServer();
|
|
|
|
# Not very elegant, but do the job for the moment as we have just 4 level
|
|
$indent = array();
|
|
$indent['dir'] = ' ';
|
|
$indent['ent'] = ' ';
|
|
$indent['att'] = ' ';
|
|
$indent['val'] = ' ';
|
|
|
|
# Print declaration
|
|
$output = sprintf('<?xml version="1.0"?>%s',$this->br);
|
|
|
|
# Print root element
|
|
$output .= sprintf('<dsml>%s',$this->br);
|
|
|
|
# Print info related to this export
|
|
$output .= sprintf('<!--%s',$this->br);
|
|
$output .= $this->getHeader();
|
|
$output .= sprintf('-->%s',$this->br);
|
|
$output .= $this->br;
|
|
|
|
$output .= sprintf('%s<directory-entries>%s',$indent['dir'],$this->br);
|
|
|
|
# Sift through the entries.
|
|
$counter = 0;
|
|
foreach ($this->results as $base => $results) {
|
|
foreach ($results as $dndetails) {
|
|
$counter++;
|
|
|
|
$dn = $dndetails['dn'];
|
|
unset($dndetails['dn']);
|
|
ksort($dndetails);
|
|
|
|
# Display DN
|
|
$output .= sprintf('%s<entry dn="%s">%s',$indent['ent'],htmlspecialchars($dn),$this->br);
|
|
|
|
# Display the objectClass attributes first
|
|
if (isset($dndetails['objectClass'])) {
|
|
if (! is_array($dndetails['objectClass']))
|
|
$dndetails['objectClass'] = array($dndetails['objectClass']);
|
|
|
|
$output .= sprintf('%s<objectClass>%s',$indent['att'],$this->br);
|
|
|
|
foreach ($dndetails['objectClass'] as $ocValue)
|
|
$output .= sprintf('%s<oc-value>%s</oc-value>%s',$indent['val'],$ocValue,$this->br);
|
|
|
|
$output .= sprintf('%s</objectClass>%s',$indent['att'],$this->br);
|
|
unset($dndetails['objectClass']);
|
|
}
|
|
|
|
# Display the attributes
|
|
foreach ($dndetails as $key => $attr) {
|
|
if (! is_array($attr))
|
|
$attr = array($attr);
|
|
|
|
$output .= sprintf('%s<attr name="%s">%s',$indent['att'],$key,$this->br);
|
|
|
|
# If the attribute is binary, set the flag $binary_mode to true
|
|
$binary_mode = $server->isAttrBinary($key) ? 1 : 0;
|
|
|
|
foreach ($attr as $value)
|
|
$output .= sprintf('%s<value>%s</value>%s',
|
|
$indent['val'],($binary_mode ? base64_encode($value) : htmlspecialchars($value)),$this->br);
|
|
|
|
$output .= sprintf('%s</attr>%s',$indent['att'],$this->br);
|
|
}
|
|
|
|
$output .= sprintf('%s</entry>%s',$indent['ent'],$this->br);
|
|
}
|
|
}
|
|
|
|
$output .= sprintf('%s</directory-entries>%s',$indent['dir'],$this->br);
|
|
$output .= sprintf('</dsml>%s',$this->br);
|
|
|
|
if ($this->compress)
|
|
return gzencode($output);
|
|
else
|
|
return $output;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Export from LDAP using an LDIF format
|
|
*
|
|
* @package phpLDAPadmin
|
|
* @subpackage Export
|
|
*/
|
|
class ExportLDIF extends Export {
|
|
# The maximum length of the ldif line
|
|
private $line_length = 76;
|
|
|
|
static public function getType() {
|
|
return array('type'=>'LDIF','description' => _('LDIF Export'),'extension'=>'ldif');
|
|
}
|
|
|
|
/**
|
|
* Export entries to LDIF format
|
|
*/
|
|
public function export() {
|
|
if (! $this->results) {
|
|
echo _('Nothing to export');
|
|
return;
|
|
}
|
|
|
|
$server = $this->getServer();
|
|
|
|
$output = $this->getHeader();
|
|
|
|
# Add our version.
|
|
$output .= 'version: 1';
|
|
$output .= $this->br;
|
|
$output .= $this->br;
|
|
|
|
# Sift through the entries.
|
|
$counter = 0;
|
|
foreach ($this->results as $base => $results) {
|
|
foreach ($results as $dndetails) {
|
|
$counter++;
|
|
|
|
$dn = $dndetails['dn'];
|
|
unset($dndetails['dn']);
|
|
ksort($dndetails);
|
|
|
|
$title_string = sprintf('# %s %s: %s%s',_('Entry'),$counter,$dn,$this->br);
|
|
|
|
if (strlen($title_string) > $this->line_length-3)
|
|
$title_string = substr($title_string,0,$this->line_length-3).'...'.$this->br;
|
|
|
|
$output .= $title_string;
|
|
|
|
# Display dn
|
|
if ($this->isSafeAscii($dn))
|
|
$output .= $this->multiLineDisplay(sprintf('dn: %s',$dn));
|
|
else
|
|
$output .= $this->multiLineDisplay(sprintf('dn:: %s',base64_encode($dn)));
|
|
|
|
# display the attributes
|
|
foreach ($dndetails as $key => $attr) {
|
|
if (! is_array($attr))
|
|
$attr = array($attr);
|
|
|
|
foreach ($attr as $value)
|
|
if (! $this->isSafeAscii($value) || $server->isAttrBinary($key))
|
|
$output .= $this->multiLineDisplay(sprintf('%s:: %s',$key,base64_encode($value)));
|
|
else
|
|
$output .= $this->multiLineDisplay(sprintf('%s: %s',$key,$value));
|
|
}
|
|
|
|
$output .= $this->br;
|
|
}
|
|
}
|
|
|
|
if ($this->compress)
|
|
return gzencode($output);
|
|
else
|
|
return $output;
|
|
}
|
|
|
|
/**
|
|
* Helper method to wrap ldif lines
|
|
*
|
|
* @param The line to be wrapped if needed.
|
|
*/
|
|
private function multiLineDisplay($str) {
|
|
$length_string = strlen($str);
|
|
$length_max = $this->line_length;
|
|
|
|
$output = '';
|
|
while ($length_string > $length_max) {
|
|
$output .= substr($str,0,$length_max).$this->br.' ';
|
|
$str = substr($str,$length_max,$length_string);
|
|
$length_string = strlen($str);
|
|
|
|
/* Need to do minus one to align on the right
|
|
* the first line with the possible following lines
|
|
* as these will have an extra space. */
|
|
$length_max = $this->line_length-1;
|
|
}
|
|
|
|
$output .= $str.$this->br;
|
|
|
|
return $output;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Export entries to VCARD v2.1
|
|
*
|
|
* @package phpLDAPadmin
|
|
* @subpackage Export
|
|
*/
|
|
class ExportVCARD extends Export {
|
|
static public function getType() {
|
|
return array('type'=>'VCARD','description' => _('VCARD 2.1 Export'),'extension'=>'vcf');
|
|
}
|
|
|
|
# Mappping one to one attribute
|
|
private $mapping = array(
|
|
'cn' => 'FN',
|
|
'title' => 'TITLE',
|
|
'homephone' => 'TEL;HOME',
|
|
'mobile' => 'TEL;CELL',
|
|
'mail' => 'EMAIL;Internet',
|
|
'labeleduri' =>'URL',
|
|
'o' => 'ORG',
|
|
'audio' => 'SOUND',
|
|
'facsmiletelephoneNumber' =>'TEL;WORK;HOME;VOICE;FAX',
|
|
'jpegphoto' => 'PHOTO;ENCODING=BASE64',
|
|
'businesscategory' => 'ROLE',
|
|
'description' => 'NOTE'
|
|
);
|
|
|
|
private $deliveryAddress = array(
|
|
'postofficebox',
|
|
'street',
|
|
'l',
|
|
'st',
|
|
'postalcode',
|
|
'c');
|
|
|
|
/**
|
|
* Export entries to VCARD format
|
|
*/
|
|
public function export() {
|
|
$server = $this->getServer();
|
|
$output = '';
|
|
|
|
# Sift through the entries.
|
|
foreach ($this->results as $base => $results) {
|
|
foreach ($results as $dndetails) {
|
|
$dndetails = array_change_key_case($dndetails);
|
|
|
|
# Check the attributes needed for the delivery address field
|
|
$addr = 'ADR:';
|
|
foreach ($this->deliveryAddress as $attr) {
|
|
if (isset($dndetails[$attr])) {
|
|
$addr .= $dndetails[$attr];
|
|
unset($dndetails[$attr]);
|
|
}
|
|
|
|
$addr .= ';';
|
|
}
|
|
|
|
$output .= sprintf('BEGIN:VCARD%s',$this->br);
|
|
|
|
# Loop for the attributes
|
|
foreach ($dndetails as $key => $attr) {
|
|
if (! is_array($attr))
|
|
$attr = array($attr);
|
|
|
|
# If an attribute of the ldap entry exist in the mapping array for vcard
|
|
if (isset($this->mapping[$key])) {
|
|
|
|
# Case of organisation. Need to append the possible ou attribute
|
|
if ($key == 'o') {
|
|
$output .= sprintf('%s:%s',$this->mapping[$key],$attr[0]);
|
|
|
|
if (isset($entry['ou']))
|
|
foreach ($entry['ou'] as $ou_value)
|
|
$output .= sprintf(';%s',$ou_value);
|
|
|
|
# The attribute is binary. (to do : need to fold the line)
|
|
} elseif (in_array($key,array('audio','jpegphoto'))) {
|
|
$output .= $this->mapping[$key].':'.$this->br;
|
|
$output .= ' '.base64_encode($attr[0]);
|
|
|
|
} else {
|
|
$output .= $this->mapping[$key].':'.$attr[0];
|
|
}
|
|
|
|
$output .= $this->br;
|
|
}
|
|
}
|
|
|
|
$output .= sprintf('UID:%s%s',isset($dndetails['entryUUID']) ? $dndetails['entryUUID'] : $dndetails['dn'],$this->br);
|
|
$output .= sprintf('VERSION:2.1%s',$this->br);
|
|
$output .= sprintf('%s%s',$addr,$this->br);
|
|
$output .= sprintf('END:VCARD%s',$this->br);
|
|
}
|
|
}
|
|
|
|
if ($this->compress)
|
|
return gzencode($output);
|
|
else
|
|
return $output;
|
|
}
|
|
}
|
|
|