1
0
mirror of https://github.com/php/doc-it.git synced 2026-03-26 00:22:14 +01:00
Files
Davide Pastore a373a2a92e Sync with EN
git-svn-id: https://svn.php.net/repository/phpdoc/it/trunk@351005 c90b9560-bf6c-de11-be94-00142212c4b1
2020-10-26 19:17:41 +00:00

149 lines
4.5 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dec1f8445ab2af7fbafef012fb7907ab2cd349b5 Maintainer: pastore Status: ready -->
<!-- CREDITS: cortesi,spisto,fernando -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.chmod">
<refnamediv>
<refname>chmod</refname>
<refpurpose>Cambia le impostazioni del file</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>chmod</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
<methodparam><type>int</type><parameter>mode</parameter></methodparam>
</methodsynopsis>
<para>
Tenta di cambiare le impostazioni del file specificato in quelle date in
<parameter>mode</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem>
<para>
Percorso del file.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
<para>
Si osservi che <parameter>mode</parameter> non viene automaticamente
assunto come valore ottale, quindi per ottenere l'operazione desiderata,
è necessario far precedere <parameter>mode</parameter> da uno zero (0).
Le stringhe come "g+w" non verranno elaborate correttamente.
</para>
<para>
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
chmod("/somedir/somefile", 755); // decimale; probabilmente errato
chmod("/somedir/somefile", "u+rwx,go+rx"); // stringa; errato
chmod("/somedir/somefile", 0755); // ottale; valore corretto di mode
?>
]]>
</programlisting>
</informalexample>
</para>
<para>
Il parametro <parameter>mode</parameter> consiste in tre numeri
ottali costituenti le restrizioni dell'accesso per il proprietario,
il gruppo utente a cui appartiene il proprietario, e gli altri utenti,
nell'ordine dato. Ciascun numero può essere calcolato aggiungendo i permessi
necessari per quel bacino di utenti di destinazione. Il numero 1 indica che
si abilita all'esecuzione del file, con il numero 2 si assegnano i permessi di
scrittura, con il numero 4 si assegna il permesso di lettura del file. Sommare
questi numeri per ottenere i permessi richiesti. Si possono avere maggiori
dettagli sui permessi dei sistemi Unix usando il comando '<command>man 1 chmod</command>'
e '<command>man 2 chmod</command>'.
</para>
<para>
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
// Lettura e scrittura per il proprietario, e nessun permesso per tutti gli altri
chmod("/somedir/somefile", 0600);
// Lettura e scrittura per il proprietario, e lettura per tutti gli altri
chmod("/somedir/somefile", 0644);
// Accesso completo per il proprietario, e lettura ed esecuzione per gli altri
chmod("/somedir/somefile", 0755);
// Accesso completo per il proprietario, e lettura ed esecuzione per il gruppo del proprietario
chmod("/somedir/somefile", 0750);
?>
]]>
</programlisting>
</informalexample>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
L'utente corrente è l'utente con il quale viene eseguito PHP. Probabilmente non è lo
stesso utente che si usa per la shell normale o per l'accesso FTP. Il mode può essere cambiato
solo dall'utente che possiede il file sulla maggior parte dei sistemi.
</para>
</note>
&note.no-remote;
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>chown</function></member>
<member><function>chgrp</function></member>
<member><function>fileperms</function></member>
<member><function>stat</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- 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
-->