Difference between revisions of "API:EPrints/Config"

From EPrints Documentation
Jump to: navigation, search
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
<!-- Pod2Wiki=_preamble_  
 
<!-- Pod2Wiki=_preamble_  
This page has been automatically generated from the EPrints 3.2 source. Any wiki changes made between the 'Pod2Wiki=*' and 'Edit below this comment' comments will be lost.
+
This page has been automatically generated from the EPrints 3.4 source. Any wiki changes made between the 'Pod2Wiki=*' and 'Edit below this comment' comments will be lost.
  -->{{API}}{{Pod2Wiki}}{{API:Source|file=perl_lib/EPrints/Config.pm|package_name=EPrints::Config}}[[Category:API|CONFIG]][[Category:API:EPrints/Config|CONFIG]]<div><!-- Edit below this comment -->
+
  -->{{API}}{{Pod2Wiki}}{{API:Source|file=EPrints/Config.pm|package_name=EPrints::Config}}[[Category:API|CONFIG]]<div><!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki=_private_ --><!-- Pod2Wiki=head_name -->
 
<!-- Pod2Wiki=_private_ --><!-- Pod2Wiki=head_name -->
 
==NAME==
 
==NAME==
'''EPrints::Config''' - software configuration handler
+
'''EPrints::Config''' - Software configuration handler.
  
 +
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 +
<span style='display:none'>User Comments</span>
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
 +
</div>
 
<!-- Pod2Wiki=head_description -->
 
<!-- Pod2Wiki=head_description -->
 
==DESCRIPTION==
 
==DESCRIPTION==
This module handles loading the main configuration for an instance of the eprints software - such as the list of language id's and the top level configurations for repositories - the XML files in /archives/
+
This module handles loading the main configuration for an instance of the EPrints repository software. Such as the list of language IDs  and the top level configurations for repositories and the XML files for the archives.
  
 +
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 +
<span style='display:none'>User Comments</span>
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
 +
</div>
 
<!-- Pod2Wiki=head_methods -->
 
<!-- Pod2Wiki=head_methods -->
 
==METHODS==
 
==METHODS==
 +
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 +
<span style='display:none'>User Comments</span>
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
 +
</div>
 
<!-- Pod2Wiki=head_deprecated_methods -->
 
<!-- Pod2Wiki=head_deprecated_methods -->
 
===Deprecated Methods===
 
===Deprecated Methods===
 +
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 +
<span style='display:none'>User Comments</span>
 +
<!-- Edit below this comment -->
 +
 +
 +
<!-- Pod2Wiki= -->
 +
</div>
 +
<!-- Pod2Wiki=item_eprints_config_abort -->
 +
====eprints_config_abort====
 +
 
  EPrints::Config::abort
 
  EPrints::Config::abort
 
Deprecated, use [[API:EPrints|EPrints]]::abort.
 
Deprecated, use [[API:EPrints|EPrints]]::abort.
 +
 +
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 +
<span style='display:none'>User Comments</span>
 +
<!-- Edit below this comment -->
 +
 +
 +
<!-- Pod2Wiki= -->
 +
</div>
 +
<!-- Pod2Wiki=item_eprints_config_get_archive_config -->
 +
====eprints_config_get_archive_config====
  
 
  EPrints::Config::get_archive_config
 
  EPrints::Config::get_archive_config
 +
Deprecated, use <em>get_repository_config</em>.
 +
 +
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 +
<span style='display:none'>User Comments</span>
 +
<!-- Edit below this comment -->
 +
 +
 +
<!-- Pod2Wiki= -->
 +
</div>
 +
<!-- Pod2Wiki=item_eprints_config_get_archive_ids -->
 +
====eprints_config_get_archive_ids====
 +
 
  EPrints::Config::get_archive_ids
 
  EPrints::Config::get_archive_ids
 +
Deprecated, use <em>get_repository_ids</em>.
 +
 +
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 +
<span style='display:none'>User Comments</span>
 +
<!-- Edit below this comment -->
 +
 +
 +
<!-- Pod2Wiki= -->
 +
</div>
 +
<!-- Pod2Wiki=item_eprints_config_load_archive_config_module -->
 +
====eprints_config_load_archive_config_module====
 +
 
  EPrints::Config::load_archive_config_module
 
  EPrints::Config::load_archive_config_module
Deprecated, use *_repository_*.
+
Deprecated, use <em>get_repository_config_module</em>.
  
 +
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 +
<span style='display:none'>User Comments</span>
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
 +
</div>
 
<!-- Pod2Wiki=head_normal_methods -->
 
<!-- Pod2Wiki=head_normal_methods -->
 
===Normal Methods===
 
===Normal Methods===
 +
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 +
<span style='display:none'>User Comments</span>
 +
<!-- Edit below this comment -->
 +
 +
 +
<!-- Pod2Wiki= -->
 +
</div>
 +
<!-- Pod2Wiki=item_init -->
 +
====init====
 +
 
  EPrints::Config::init()
 
  EPrints::Config::init()
 
Load the EPrints configuration.
 
Load the EPrints configuration.
Line 47: Line 113:
 
Do not use this method directly, it will be automatically called when using EPrints.
 
Do not use this method directly, it will be automatically called when using EPrints.
  
Defines the following configuration properties:
+
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 +
<span style='display:none'>User Comments</span>
 +
<!-- Edit below this comment -->
 +
 
  
<pre> cgi_path /cgi
+
<!-- Pod2Wiki= -->
  cfg_path /cfg
+
</div>
  lib_path /lib
+
<!-- Pod2Wiki=item_load_system_config -->
  arc_path /archives
+
====load_system_config====
  bin_path /bin
 
  var_path /var</pre>
 
  
 
  EPrints::Config::load_system_config()
 
  EPrints::Config::load_system_config()
 
Load the system configuration files.
 
Load the system configuration files.
  
Configuration files are loaded in order from (later files with the same name will be ignored):
+
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 +
<span style='display:none'>User Comments</span>
 +
<!-- Edit below this comment -->
  
<pre> /cfg/cfg.d
+
 
  /lib/syscfg.d</pre>
+
<!-- Pod2Wiki= -->
 +
</div>
 +
<!-- Pod2Wiki=item_system_config -->
 +
====system_config====
  
 
  $conf = EPrints::Config::system_config()
 
  $conf = EPrints::Config::system_config()
Returns the system configuration variable. To access a specific configuration option use [[API:EPrints/Config#get|get]].
+
Returns the system configuration variable. To access a specific configuration option use [[API:EPrints/Config#get|get]].
 +
 
 +
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 +
<span style='display:none'>User Comments</span>
 +
<!-- Edit below this comment -->
 +
 
 +
 
 +
<!-- Pod2Wiki= -->
 +
</div>
 +
<!-- Pod2Wiki=item_get_repository_config -->
 +
====get_repository_config====
  
 
  $repository = EPrints::Config::get_repository_config( $id )
 
  $repository = EPrints::Config::get_repository_config( $id )
 
Returns a hash of the basic configuration for the repository with the given id. This hash will include the properties from SystemSettings.
 
Returns a hash of the basic configuration for the repository with the given id. This hash will include the properties from SystemSettings.
  
@ids = EPrints::Config::get_repository_ids()
+
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
Return a list of ids of all repositories belonging to this instance of the eprints software.
+
<span style='display:none'>User Comments</span>
 +
<!-- Edit below this comment -->
  
$arc_conf = EPrints::Config::load_repository_config_module( $id )
 
Load the full configuration for the specified repository.
 
  
Returns a reference to a hash containing the full repository configuration.
+
<!-- Pod2Wiki= -->
 +
</div>
 +
<!-- Pod2Wiki=item_get_repository_ids -->
 +
====get_repository_ids====
  
Configuration files are loaded in order from (later files with the same name will be ignored):
+
@ids = EPrints::Config::get_repository_ids()
 +
Return a list of ids of all repositories belonging to this instance of the EPrints repository software.
  
<pre> archives/[archiveid]/cfg/cfg.d
+
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
  site_lib/cfg.d
+
<span style='display:none'>User Comments</span>
  lib/cfg.d</pre>
+
<!-- Edit below this comment -->
  
Defines the following configuration properties:
 
  
<pre> archiveroot    archives/[archiveid]
+
<!-- Pod2Wiki= -->
  documents_path archives/[archiveid]/documents
+
</div>
  config_path    archives/[archiveid]/cfg
+
<!-- Pod2Wiki=item_load_repository_config_module -->
  htdocs_path    archives/[archiveid]/html
+
====load_repository_config_module====
  cgi_path      archives/[archiveid]/cgi</pre>
 
  
  $value = EPrints::Config::get( $confitem )
+
  $arc_conf = EPrints::Config::load_repository_config_module( $id )
Return the value of a given eprints configuration item. These values are obtained from SystemSettings plus a few extras for paths.
+
Load the full configuration for the specified repository unless the  it has already been loaded.
  
$ok = EPrints::Config::write_config( $dest, $names, $values )
+
Return a reference to a hash containing the full repository  configuration.  
Write name-value pairs to a configuration file $dest (overwriting any existing data). This uses [[API:EPrints/Dumper|EPrints::Dumper]] to serialise the passed Perl structures.
 
  
 +
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 +
<span style='display:none'>User Comments</span>
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
<!-- Pod2Wiki=head_copyright -->
+
</div>
==COPYRIGHT==
+
<!-- Pod2Wiki=item_get -->
Copyright 2000-2011 University of Southampton.
+
====get====
  
This file is part of EPrints http://www.eprints.org/.
+
$value = EPrints::Config::get( $confitem )
 +
Return the value of a given eprints configuration item. These values  are obtained from [[API:EPrints/SystemSettings|EPrints::SystemSettings]] plus a few extras for paths.
  
EPrints is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 +
<span style='display:none'>User Comments</span>
 +
<!-- Edit below this comment -->
  
EPrints 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 Lesser General Public License for more details.
 
 
You should have received a copy of the GNU Lesser General Public License along with EPrints.  If not, see http://www.gnu.org/licenses/.
 
  
 +
<!-- Pod2Wiki= -->
 +
</div>
 +
<!-- Pod2Wiki=head_copyright -->
 +
==COPYRIGHT==
 +
{{API:Copyright}}
 +
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 +
<span style='display:none'>User Comments</span>
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
<!-- Pod2Wiki=_postamble_ -->
+
</div>
<!-- Edit below this comment -->
+
<!-- Pod2Wiki=_postamble_ --><!-- Edit below this comment -->

Latest revision as of 12:53, 4 March 2022

EPrints 3 Reference: Directory Structure - Metadata Fields - Repository Configuration - XML Config Files - XML Export Format - EPrints data structure - Core API - Data Objects


API: Core API

Latest Source Code (3.4, 3.3) | Revision Log | Before editing this page please read Pod2Wiki


NAME

EPrints::Config - Software configuration handler.

User Comments


DESCRIPTION

This module handles loading the main configuration for an instance of the EPrints repository software. Such as the list of language IDs and the top level configurations for repositories and the XML files for the archives.

User Comments


METHODS

User Comments


Deprecated Methods

User Comments


eprints_config_abort

EPrints::Config::abort

Deprecated, use EPrints::abort.

User Comments


eprints_config_get_archive_config

EPrints::Config::get_archive_config

Deprecated, use get_repository_config.

User Comments


eprints_config_get_archive_ids

EPrints::Config::get_archive_ids

Deprecated, use get_repository_ids.

User Comments


eprints_config_load_archive_config_module

EPrints::Config::load_archive_config_module

Deprecated, use get_repository_config_module.

User Comments


Normal Methods

User Comments


init

EPrints::Config::init()

Load the EPrints configuration.

Do not use this method directly, it will be automatically called when using EPrints.

User Comments


load_system_config

EPrints::Config::load_system_config()

Load the system configuration files.

User Comments


system_config

$conf = EPrints::Config::system_config()

Returns the system configuration variable. To access a specific configuration option use get.

User Comments


get_repository_config

$repository = EPrints::Config::get_repository_config( $id )

Returns a hash of the basic configuration for the repository with the given id. This hash will include the properties from SystemSettings.

User Comments


get_repository_ids

@ids = EPrints::Config::get_repository_ids()

Return a list of ids of all repositories belonging to this instance of the EPrints repository software.

User Comments


load_repository_config_module

$arc_conf = EPrints::Config::load_repository_config_module( $id )

Load the full configuration for the specified repository unless the it has already been loaded.

Return a reference to a hash containing the full repository configuration.

User Comments


get

$value = EPrints::Config::get( $confitem )

Return the value of a given eprints configuration item. These values are obtained from EPrints::SystemSettings plus a few extras for paths.

User Comments


COPYRIGHT

© Copyright 2023 University of Southampton.

EPrints 3.4 is supplied by EPrints Services.

http://www.eprints.org/eprints-3.4/

LICENSE

This file is part of EPrints 3.4 http://www.eprints.org/.

EPrints 3.4 and this file are released under the terms of the GNU Lesser General Public License version 3 as published by the Free Software Foundation unless otherwise stated.

EPrints 3.4 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 Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with EPrints 3.4. If not, see http://www.gnu.org/licenses/.

User Comments