svn: /phpdoc/it/trunk/language/oop5/ autoload.xml

From: Date: Tue, 22 Jun 2010 11:25:24 +0000
Subject: svn: /phpdoc/it/trunk/language/oop5/ autoload.xml
Groups: php.doc.it 
Request: Send a blank email to doc-it+get-963@lists.php.net to get a copy of this message
cucinato Tue, 22 Jun 2010 11:25:24 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=300654 Log: Sync with EN Changed paths: A phpdoc/it/trunk/language/oop5/autoload.xml Added: phpdoc/it/trunk/language/oop5/autoload.xml =================================================================== --- phpdoc/it/trunk/language/oop5/autoload.xml (rev 0) +++ phpdoc/it/trunk/language/oop5/autoload.xml 2010-06-22 11:25:24 UTC (rev 300654) @@ -0,0 +1,184 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- EN-Revision: 299619 Maintainer: butera Status: ready --> +<sect1 xml:id="language.oop5.autoload" xmlns="http://docbook.org/ns/docbook"> +<title>Caricamento automatico delle classi</title> +<para> +Molti sviluppatori che producono applicazioni orientate agli oggetti creano +un file sorgente PHP per ogni classe definita. Uno dei più grossi inconvenienti +di questo approccio è la necessità di mantenere una lunga lista di +inclusioni all'inizio di ogni script (un'inclusione per ogni classe). +</para> +<para> +In PHP 5, ciò non è più necessario, in quanto è possibile definire una +funzione __autoload che viene automaticamente +invocata in caso si stia cercando di usare una classe/interfaccia che non sia stata +ancora definita. Chiamando questa funzione, il motore di scripting ha una ultima +possibilità di caricare la classe prima che PHP termini l'esecuzione con un errore. +</para> +<note> +<para> +Prima di 5.3.0, le eccezioni sollevate dalla funzione __autoload non potevano essere +intercettate nel blocco <link linkend="language.exceptions">catch</link> e +avrebbero portato ad un errore fatale. Da 5.3.0+ le eccezioni sollevate nella +funzione __autoload possono essere intercettate nel blocco <link linkend="language.exceptions"> +catch</link>, con la sola precisazione che se si sta sollevando un'eccezione definita dall'utente +la classe in cui l'eccezione viene definita deve essere disponibile. La funzione __autoload può +essere usata ricorsivamente per caricare la classe dell'eccezione personalizzata. +</para> +</note> +<note> +<para> +La funzionalità di autocaricamento non è disponibile se si sta usando PHP nella +<link linkend="features.commandline">modalità interattiva</link> di CLI. +</para> +</note> +<note> +<para> +Se il nome di classe è usato ad esempio in <function>call_user_func</function> esso +può contenere alcuni caratteri pericolosi come <literal>../</literal>. +Si raccomanda di non usare direttamente valori inputati dall'utente in tali funzioni, o quanto meno di +verificare l'input <function>__autoload</function>. +</para> +</note> +<para> +<example> +<title>Esempio di autocaricamento</title> +<para> +Questo esempio cerca di caricare le classi <literal>MyClass1</literal> +e <literal>MyClass2</literal> rispettivamente dai file <filename>MyClass1.php</filename> +e <filename>MyClass2.php</filename>. +</para> +<programlisting role="php"> +<![CDATA[ +<?php +function __autoload($class_name) { +require_once $class_name . '.php'; +} + +$obj = new MyClass1(); +$obj2 = new MyClass2(); +?> +]]> +</programlisting> +</example> +<example> +<title>Altro esempio di autocaricamento</title> +<para> +Questo esempio tenta di caricare l'interfaccia <literal>ITest</literal>. +</para> +<programlisting role="php"> +<![CDATA[ +<?php + +function __autoload($name) { +var_dump($name); +} + +class Foo implements ITest { +} + +/* +string(5) "ITest" + +Fatal error: Interface 'ITest' not found in ... +*/ +?> +]]> +</programlisting> +</example> +<example> +<title>Autocaricamento con gestione delle eccezioni per 5.3.0+</title> +<para> +Questo esempio solleva un'eccezione e dimostra come intercettarla con il blocco try/catch. +</para> +<programlisting role="php"> +<![CDATA[ +<?php +function __autoload($name) { +echo "Si vuole caricare $name.\n"; +throw new Exception("Impossibile caricare $name."); +} + +try { +$obj = new NonLoadableClass(); +} catch (Exception $e) { +echo $e->getMessage(), "\n"; +} +?> +]]> +</programlisting> +&example.outputs; +<screen> +<![CDATA[ +Si vuole caricare NonLoadableClass. +Impossibile caricare NonLoadableClass. +]]> +</screen> +</example> +<example> +<title>Autocaricamento con gestione delle eccezioni per 5.3.0+ - Classe dell'eccezione personalizzata mancante</title> +<para> +Questo esempio solleva un'eccezione per una eccezione personalizzata non caricabile. +</para> +<programlisting role="php"> +<![CDATA[ +<?php +function __autoload($name) { +echo "Si vuole caricare $name.\n"; +throw new MissingException("Impossibile $name."); +} + +try { +$obj = new NonLoadableClass(); +} catch (Exception $e) { +echo $e->getMessage(), "\n"; +} +?> +]]> +</programlisting> +&example.outputs; +<screen> +<![CDATA[ +Si vuole caricare NonLoadableClass. +Si vuole caricare MissingException. + +Fatal error: Class 'MissingException' not found in testMissingException.php on line 4 +]]> +</screen> +</example> +</para> + +<simplesect role="seealso"> +&reftitle.seealso; +<para> +<simplelist> +<member><function>unserialize</function></member> +<member><link linkend="unserialize-callback-func">unserialize_callback_func</link></member> +<member><function>spl_autoload</function></member> +<member><function>spl_autoload_register</function></member> +</simplelist> +</para> +</simplesect> + +</sect1> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"~/.phpdoc/manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> \ No newline at end of file Property changes on: phpdoc/it/trunk/language/oop5/autoload.xml ___________________________________________________________________ Added: svn:keywords + Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL Added: svn:eol-style + native

« previous php.doc.it (#963) next »