home *** CD-ROM | disk | FTP | other *** search
/ Cricao de Sites - 650 Layouts Prontos / WebMasters.iso / Servidores / xampp-win32-1.6.7-installer.exe / php / PEAR / HTML / QuickForm2 / DataSource / Submit.php < prev    next >
Encoding:
PHP Script  |  2008-07-02  |  3.1 KB  |  78 lines
  1. <?php
  2. /**
  3.  * Interface for data sources containing submitted values
  4.  *
  5.  * PHP version 5
  6.  *
  7.  * LICENSE:
  8.  * 
  9.  * Copyright (c) 2006, 2007, Alexey Borzov <avb@php.net>,
  10.  *                           Bertrand Mansion <golgote@mamasam.com>
  11.  * All rights reserved.
  12.  *
  13.  * Redistribution and use in source and binary forms, with or without
  14.  * modification, are permitted provided that the following conditions
  15.  * are met:
  16.  *
  17.  *    * Redistributions of source code must retain the above copyright
  18.  *      notice, this list of conditions and the following disclaimer.
  19.  *    * Redistributions in binary form must reproduce the above copyright
  20.  *      notice, this list of conditions and the following disclaimer in the 
  21.  *      documentation and/or other materials provided with the distribution.
  22.  *    * The names of the authors may not be used to endorse or promote products 
  23.  *      derived from this software without specific prior written permission.
  24.  *
  25.  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
  26.  * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
  27.  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  28.  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
  29.  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  30.  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  31.  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  32.  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  33.  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
  34.  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  35.  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  36.  *
  37.  * @category   HTML
  38.  * @package    HTML_QuickForm2
  39.  * @author     Alexey Borzov <avb@php.net>
  40.  * @author     Bertrand Mansion <golgote@mamasam.com>
  41.  * @license    http://opensource.org/licenses/bsd-license.php New BSD License
  42.  * @version    CVS: $Id: Submit.php,v 1.1 2007/04/06 17:06:55 avb Exp $
  43.  * @link       http://pear.php.net/package/HTML_QuickForm2
  44.  */
  45.  
  46. /**
  47.  * Interface for data sources used by HTML_QuickForm2 objects
  48.  */
  49. require_once 'HTML/QuickForm2/DataSource.php';
  50.  
  51. /**
  52.  * Interface for data sources containing submitted values
  53.  *
  54.  * This interface provides method for getting information on uploaded files.
  55.  * Additionally some elements will only consider getting their values from data
  56.  * sources implementing this interface.
  57.  *
  58.  * @category   HTML
  59.  * @package    HTML_QuickForm2
  60.  * @author     Alexey Borzov <avb@php.net>
  61.  * @author     Bertrand Mansion <golgote@mamasam.com>
  62.  * @version    Release: 0.2.0
  63.  * @todo       Add filters handling
  64.  */
  65. interface HTML_QuickForm2_DataSource_Submit extends HTML_QuickForm2_DataSource
  66. {
  67.    /**
  68.     * Returns the information about uploaded file
  69.     *
  70.     * If data source doesn't such information it should return null 
  71.     *
  72.     * @param    string      Name of file upload field 
  73.     * @return   array|null  Information on uploaded file, from $_FILES array
  74.     */
  75.     public function getUpload($name);
  76. }
  77. ?>
  78.