svn: /phpdoc/it/trunk/language/oop5/ autoload.xml
| From: | Marco Cucinato | 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