itsmelepassos/phpoo-timezone

无需修改php.ini文件即可分配本地时区

v1.1.0 2021-08-18 22:03 UTC

This package is auto-updated.

Last update: 2024-09-30 04:58:47 UTC


README

Maintainer Source Code PHP from Packagist Latest Version Software License Build Quality Score Total Downloads

EN: PHPOO-Timezone 是一个允许开发者在不修改服务器 php.ini 文件的情况下更改软件时区的包。

PT-BR: PHPOO-Timezone é um pacote que permite que o desenvolvedor altere o fuso horário em seu software sem a necessidade de se alterar o arquivo php.ini do seu servidor.

亮点/Destaques

  • EN: 简单安装

    • PT-BR: Instalação Simples
  • EN: PSR-2 和 PSR-4 已就绪

    • PT-BR: Pronto para os padrões PSR-2 e PSR-4
  • EN: 通过 Composer 安装

    • PT-BR: Instalável via Composer

EN: 在安装之前,请确保您已安装 Composer 2.x(不支持 Composer 1.x)

PT-BR: Antes de instalar, certifique-se de estar com o Composer 2.x instalado (Composer 1.x não é suportado)

EN: 如何在我的项目中安装?答:在您的 composer.json 文件中插入以下行,作为 "require" 部分

PT-BR: Como instalar em meu projeto? R: Insira esta linha abaixo em seu arquivo composer.json, como um "require"

"itsmelepassos/phpoo-timezone": "^1.0"
EN: 或者,在您的终端或 bash 中输入以下命令

PT-BR: Ou digite este comando em seu terminal ou bash

composer require itsmelepassos/phpoo-timezone

文档/文档ação

EN: 在 "example" 文件夹中有一个如何直接在 index.php 文件中调用 Timezone 的示例文件,或者您也可以参考下面的代码作为示例。

PT-BR: Há um arquivo de exemplo de como você pode chamar direto o Timezone em seu arquivo index.php na pasta "example", ou pode também consultar o código abaixo para servir como exemplo

<?php

/**
 * Calls the composer autoload. Then, calls the respective class for the timezone.
 * Chama o autoload do composer. Então, chame a classe respectiva para o fuso-horário.
 */
require __DIR__ . "/../vendor/autoload.php";

use ItsMeLePassos\Timezone\Timezone;

/**
 * Calls the method setTimezone and with one the supported timezones (https://php.ac.cn/manual/en/timezones.php).
 * Chama o método setTimezone com um dos fusos-horários suportados (https://php.ac.cn/manual/en/timezones.php).
 *
 * It can also be used in a central controller in your project.
 * Pode também ser usado em um controlador central no seu projeto.
 */
(new Timezone())->timezone('America/Sao_Paulo');

/**
 * Displays the time corresponding to the timezone configured above.
 * Exibe a hora correspondente ao fuso-horário configurado acima
 */
echo date('d/m/Y H:i:s');
EN: 翻译结果如果您想在任何控制器中使用它,建议将其插入到系统的通用控制器中,并按以下方式调用,直接在调用 timezone 方法时插入参数,或一个变量,或一个常量

PT-BR: Caso queira usar em algum controlador, a recomendação é inserir no Controller geral do seu sistema e chamar da seguinte forma, inserindo diretamente o parâmetro ao chamar o método tiemzone, ou uma variável, ou uma constante

<?php
use ItsMeLePassos\Timezone\Timezone;

class Controller
{
    /** @var Timezone */
    protected $timezone;
    
    /**
     * Controller constructor.
     */
    public function __construct()
    {
        $this->timezone = (new Timezone())->timezone('America/Sao_Paulo');
    }
}
<?php

/**
 * EN: No need to call anything else: the inherited class's constructor already assigns the custom timezone.
 * PT-BR: Não precisa chamar mais nada: o construtor da classe herdada já atribui o fuso horário personalizado.
 */
class FooController extends Controller
{
    
}

支持/Suporte

EN: 如果您发现任何漏洞,建议一些修复或希望为项目做出贡献,请通过电子邮件联系开发者(我)[itsmelepassos@gmail.com]

PT-BR: No caso de descobrir alguma vulnerabilidade, sugerir algumas correções ou desejar contribuir para o projeto, entre em contato com o desenvolvedor (eu) por e-mail [itsmelepassos@gmail.com]

EN: 测试/实施轻松

PT-BR: Teste/implemente à vontade

感谢/Obrigado

致谢/Créditos

许可证

MIT 许可证 (MIT)。有关更多信息,请参阅 许可证文件