Melhor maneira de abortar o plugin em caso de versão PHP insuficiente?

15

Você escreve um plugin que requer PHP 5.1. Alguém tenta instalá-lo em um servidor com PHP 4. Como você lida com isso de uma maneira segura e amigável?

Geert
fonte
Por que você precisaria disso? O WP não roda mais no PHP <5
onetrickpony 13/12/12
É uma pergunta geral. Você pode querer exigir qualquer outra versão superior do PHP. Dito isto, eu não sabia que o PHP 5.2.4 é necessário desde o WP 3.2 .
21812 Geert #
2
Para aqueles que procuram os requisitos de PHP de um plug-in já existente, faça um favor aos usuários existentes, impedindo que ele seja atualizado para a nova versão se os requisitos não forem atendidos. Um exemplo do BuddyPress . É preciso alguma preparação nas versões anteriores do seu plug-in, mas seus usuários agradecerão. Acabei de fazer algo semelhante no WordPoints , caso decida atualizar os requisitos do PHP no futuro.
JD

Respostas:

15

Essa função e o gancho de ativação impedem a ativação do plug-in e permitem verificar a versão mínima do PHP e do WordPress.

register_activation_hook( __FILE__, array( 'Your_Plugin_Class_Name', 'activate' ) );

/**
  * Plugin Activation hook function to check for Minimum PHP and WordPress versions
  * @param string $wp Minimum version of WordPress required for this plugin
  * @param string $php Minimum version of PHP required for this plugin
  */
 function activate( $wp = '3.1', $php = '5.2.4' ) {
    global $wp_version;
    if ( version_compare( PHP_VERSION, $php, '<' ) )
        $flag = 'PHP';
    elseif
        ( version_compare( $wp_version, $wp, '<' ) )
        $flag = 'WordPress';
    else
        return;
    $version = 'PHP' == $flag ? $php : $wp;
    deactivate_plugins( basename( __FILE__ ) );
    wp_die('<p>The <strong>Insert PLugin Name Here</strong> plugin requires'.$flag.'  version '.$version.' or greater.</p>','Plugin Activation Error',  array( 'response'=>200, 'back_link'=>TRUE ) );
}
Chris_O
fonte
Esta não funcionam se devido à sintaxe php altera o arquivo php não pode ser analisado em tudo
Mark Kaplun
10
/**
 * Plugin Name: Foo
 */

// Check for required PHP version
if ( version_compare( PHP_VERSION, '5.1', '<' ) )
{
    exit( sprintf( 'Foo requires PHP 5.1 or higher. You’re still on %s.', PHP_VERSION ) );
}

// The rest of your plugin code follows

Não sei desde que versão do WP isso aconteceu, mas na versão 3.5 o plug-in falha na ativação e a mensagem de erro é mostrada ao usuário no administrador, o que é legal.

A mensagem de erro não é traduzida, no entanto. Para fazer isso, você precisará carregar seus arquivos de tradução imediatamente antes da exitchamada.

Geert
fonte
Acho que ainda prefiro esse método por sua simplicidade. Além disso, o plug-in nunca é realmente instalado, portanto, não há necessidade de acionar rotinas de desinstalação no caso de uma versão PHP muito antiga.
quer
6

Você pode ativá-lo e mostrar uma mensagem de erro:

// if PHP version is lower than 5.1
if(version_compare(PHP_VERSION, '5.1') < 0){

  // show a message inside the dashboard
  if(is_admin()){

    function my_plugin_notice(){      
      ?>
      <div class="error below-h2">
        <p>
        <?php
          printf(__('The abc plugin requires at least PHP 5.1. You have %s'), PHP_VERSION);
         ?>
        </p>
      </div>
      <?php
    }

    add_action('admin_notices', 'my_plugin_notice');

  }

  // stop here and do nothing further
  return;  
}

// if PHP version is equal or higher than 5.1
require dirname(__FILE__) . '/php51code.php';

Provavelmente, também é possível desativá-lo programaticamente, antes da declaração de retorno ...

onetrickpony
fonte
Sim, você ainda precisa desativá-lo programaticamente se usar essa configuração, porque, apesar do aviso do administrador, o plug-in aparecerá como ativado.
Geert
1
Vejadeactivate_plugins
onetrickpony 13/12/12
1
a função version_comparepossui um triplo parâmetro para a comparação; por favor useif ( version_compare( phpversion(), '5.1a', '<' ) )
bueltge
1
Isso é necessário apenas quando você deseja que esta função retorne booleano
onetrickpony
Mas, o valor booleano é mais rápido como uma comparação com o valor inteiro 0. #
bueltge
0

Sei que essa é uma pergunta antiga, mas para aqueles que procuram uma boa solução, Gary Pendergast tinha um bom caminho a percorrer, que abrange algumas das bases mencionadas nas outras respostas (veja o post dele aqui , atualizei o código abaixo para verificar a versão do PHP, mas você pode usá-la para praticamente qualquer verificação):

//  In this example, only allow activation on WordPress 3.7 or higherclass 
MyPlugin {
function __construct() {
    add_action( 'admin_init', array( $this, 'check_version' ) );

    // Don't run anything else in the plugin, if we're on an incompatible WordPress version
    if ( ! self::compatible_version() ) {
        return;
    }
}

// The primary sanity check, automatically disable the plugin on activation if it doesn't// meet minimum requirements.static
function activation_check() {
    if ( ! self::compatible_version() ) {
        deactivate_plugins( plugin_basename( __FILE__ ) );
        wp_die( __( 'My Plugin requires PHP 5.1 or higher!', 'my-plugin' ) );
    }
}

// The backup sanity check, in case the plugin is activated in a weird way,
// or the versions change after activation.
function check_version() {
    if ( ! self::compatible_version() ) {
        if ( is_plugin_active( plugin_basename( __FILE__ ) ) ) {
            deactivate_plugins( plugin_basename( __FILE__ ) );
            add_action( 'admin_notices', array( $this, 'disabled_notice' ) );

            if ( isset( $_GET['activate'] ) ) {
                unset( $_GET['activate'] );
            }
        }
    }
}

function disabled_notice() {
    echo '<strong>' . esc_html__( 'My Plugin requires PHP 5.1 or higher!', 'my-plugin' ) . '</strong>';
}

static function compatible_version() {
    if ( version_compare(PHP_VERSION, '5.1', '<') ) {
        return false;
    }

    // Add sanity checks for other version requirements here

    return true;
}
}
global $myplugin;
$myplugin = new MyPlugin();
register_activation_hook( __FILE__, array( 'MyPlugin', 'activation_check' ) );

Também salvei o código acima em uma essência .

Joshua Nelson
fonte
O que diabos é isso?!
Andrei Surdu