Utilizzare phpMyAdmin con Cloud SQL nell'ambiente standard di App Engine


Scopri come installare phpMyAdmin nell'ambiente standard di App Engine. Puoi utilizzare phpMyAdmin per amministrare Cloud SQL sul web.

Questo tutorial ti sarà utile se:

  • Esegui applicazioni su App Engine.
  • Utilizza Cloud SQL come database.
  • Utilizza phpMyAdmin come interfaccia per MySQL o preferisci un'interfaccia web per l'amministrazione del database.

Se utilizzi Compute Engine, valuta la possibilità di utilizzare uno degli stack di sviluppo o dei prodotti disponibili tramite Click to Deploy. I deployment di stack che includono MySQL, come LAMP e LEMP, o prodotti come Drupal, offrono un'opzione per installare phpMyAdmin come parte del deployment.

Obiettivi

  • Esegui il deployment di phpMyAdmin nell'ambiente standard di App Engine.

Costi

Questo tutorial utilizza i componenti fatturabili di Cloud Platform, tra cui:

  • App Engine
  • Cloud SQL

Utilizza il Calcolatore prezzi per generare una stima dei costi in base all'utilizzo previsto.

I nuovi utenti di Cloud Platform potrebbero avere diritto a una prova gratuita.

Prima di iniziare

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Install the gcloud CLI.

  5. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  6. To initialize the gcloud CLI, run the following command:

    gcloud init
  7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  8. Make sure that billing is enabled for your Google Cloud project.

  9. Install the gcloud CLI.

  10. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  11. To initialize the gcloud CLI, run the following command:

    gcloud init
  12. Crea un'istanza Cloud SQL di seconda generazione.
  13. (Facoltativo) Esegui il deployment di un'applicazione App Engine che utilizza l'istanza Cloud SQL o seleziona un'applicazione esistente.

    Ad esempio, crea ed esegui il deployment dell'esempio di guestbook. Anche se puoi eseguire il deployment di phpMyAdmin autonomamente, probabilmente vorrai utilizzarlo con un'applicazione App Engine nel tuo scenario reale.

Scarica il codice sorgente di phpMyAdmin

Esegui il deployment di phpMyAdmin come servizio dell'applicazione App Engine, quindi devi scaricare il codice sorgente di phpMyAdmin. Segui questi passaggi:

  1. In un terminale Cloud Shell, inserisci questo comando per scaricare il codice sorgente per phpMyAdmin versione 4.9.5:

    wget https://files.phpmyadmin.net/phpMyAdmin/4.9.5/phpMyAdmin-4.9.5-all-languages.tar.gz
    

    Per utilizzare una versione diversa di phpMyAdmin, utilizza i link alle versioni disponibili nella pagina dei download di phpMyAdmin.

  2. Crea una nuova directory. I file verranno estratti in questa directory.

    mkdir phpMyAdmin
    
  3. Estrai i file dall'archivio nella nuova directory.

    tar -xzvf phpMyAdmin-4.9.5-all-languages.tar.gz -C phpMyAdmin --strip-components=1
    

Preparare i file per il deployment

Il deployment di phpMyAdmin richiede la creazione di tre file: app.yaml, che contiene le informazioni di configurazione per App Engine; config.inc.php, che contiene le informazioni di configurazione per phpMyAdmin; e php.ini, che contiene la configurazione specifica dell'applicazione per PHP.

Crea app.yaml

Il file di configurazione di App Engine specifica la corrispondenza tra i percorsi URL e i gestori di richieste e i file statici. Contiene anche informazioni sul codice dell'applicazione, come l'ID applicazione e l'identificatore dell'ultima versione. Per creare il file:

  1. Nella directory che hai creato, denominata phpMyAdmin, crea un nuovo file denominato app.yaml.

    cd phpMyAdmin
    touch app.yaml
    
  2. Utilizzando il tuo editor preferito, incolla il seguente testo in app.yaml.

    service: phpmyadmin
    runtime: php55
    api_version: 1
    
    handlers:
    
    - url: /(.+\.(ico|jpg|png|gif))$
      static_files: \1
      upload: (.+\.(ico|jpg|png|gif))$
      application_readable: true
    
    - url: /(.+\.(htm|html|css|js))$
      static_files: \1
      upload: (.+\.(htm|html|css|js))$
      application_readable: true
    
    - url: /(.+\.php)$
      script: \1
      login: admin
    
    - url: /.*
      script: index.php
      login: admin
    
  3. Se stai eseguendo il deployment di phpMyAdmin come prima e unica applicazione in App Engine, modifica il valore di service da phpmyadmin a default.

    In genere, phpMyAdmin viene implementato come servizio di un'applicazione esistente e viene fornito un nome per il servizio. Tuttavia, se non hai ancora eseguito il deployment di un'applicazione, devi utilizzare il nome del servizio "default". Ai fini di questo tutorial, va bene se stai provando phpMyAdmin su App Engine.

    Questo tutorial funziona solo per l'ambiente standard di App Engine.

  4. Salva il file.

Crea config.inc.php

Per creare il file di configurazione di phpMyAdmin:

  1. Crea un nuovo file denominato config.inc.php.

    touch config.inc.php
    
  2. Utilizzando il tuo editor preferito, incolla il seguente testo in config.inc.php.

    <?php
    /**
     * Copyright 2016 Google Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *     http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    /*
     * This is needed for cookie based authentication to encrypt password in
     * cookie
     * http://www.question-defense.com/tools/phpmyadmin-blowfish-secret-generator
     */
    $cfg['blowfish_secret'] = '{{your_secret}}'; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */
    
    /*
     * Servers configuration
     */
    $i = 0;
    
    // Change this to use the project and instance that you've created.
    $host = '/cloudsql/{{your_connection_string}}';
    $type = 'socket';
    
    /*
    * First server
    */
    $i++;
    /* Authentication type */
    $cfg['Servers'][$i]['auth_type'] = 'cookie';
    /* Server parameters */
    $cfg['Servers'][$i]['socket'] = $host;
    $cfg['Servers'][$i]['connect_type'] = $type;
    $cfg['Servers'][$i]['compress'] = false;
    /* Select mysql if your server does not have mysqli */
    $cfg['Servers'][$i]['extension'] = 'mysqli';
    $cfg['Servers'][$i]['AllowNoPassword'] = true;
    /*
     * End of servers configuration
     */
    
    /*
     * Directories for saving/loading files from server
     */
    $cfg['UploadDir'] = '';
    $cfg['SaveDir'] = '';
    
    /*
    * Other settings
    */
    $cfg['PmaNoRelation_DisableWarning'] = true;
    $cfg['ExecTimeLimit'] = 60;
    $cfg['CheckConfigurationPermissions'] = false;
    
  3. Apri Google Cloud Shell ed esegui il comando seguente per ottenere una stringa casuale per Blowfish:

    php -r "echo password_hash(uniqid(), PASSWORD_BCRYPT).PHP_EOL;"
    
  4. Incolla il nuovo segreto al posto di {{your_secret}} in config.inc.php.

  5. Vai alla pagina delle istanze Cloud SQL nella console Google Cloud .

  6. Fai clic sull'istanza Cloud SQL per visualizzare la pagina dei dettagli dell'istanza.

  7. Sostituisci il valore di {{your_connection_string}} (all'interno della variabile $host) con la proprietà Nome connessione dell'istanza.

  8. Salva il file.

Crea php.ini

Nel suo codice, phpMyAdmin utilizza funzioni disattivate per impostazione predefinita in App Engine. Per aggiungere un file php.ini in modo che App Engine riattivi le funzioni:

  1. Crea il file nella directory phpMyAdmin.

    touch php.ini
    
  2. Modifica il file e aggiungi la seguente riga:

    google_app_engine.enable_functions = "php_uname, getmypid"
    
  3. Salva il file.

Esegui il deployment dell'applicazione

Utilizza i seguenti comandi per eseguire il deployment dell'applicazione in App Engine.

  1. Verifica la disponibilità di aggiornamenti per i componenti gcloud.

    gcloud components update
    
  2. Esegui il deployment dell'applicazione eseguendo questo comando dalla directory phpMyAdmin in cui si trova il file app.yaml:

    gcloud app deploy
    

    Questo comando esegue il deployment dell'app nel servizio phpMyAdmin, come specificato nel file app.yaml. Il deployment in un servizio separato contribuisce a garantire che phpMyAdmin venga eseguito nello stesso data center dell'applicazione principale, il che migliora le prestazioni. Per scoprire di più sul deployment dell'app dalla riga di comando, consulta l'articolo Deployment di un'app PHP.

Accedi a phpMyAdmin

Ora puoi accedere a phpMyAdmin.

  1. Nel browser web, inserisci l'URL di phpMyAdmin per aprire la pagina di benvenuto, modificando l'URL in modo che utilizzi l'ID app.

        https://phpmyadmin-dot-[YOUR_APP_ID].appspot.com
    
  2. In Nome utente, inserisci root.

  3. Inserisci la password root che hai fornito quando hai configurato l'account root.

  4. Fai clic su Vai.

Durante lo sviluppo dell'app App Engine, ricordati di proteggere con password tutti gli account utente che crei per accedere ai database in Cloud SQL.

Risoluzione dei problemi

App Engine utilizza il proxy di autenticazione Cloud SQL per connettersi alle istanze Cloud SQL di seconda generazione. Per saperne di più sul funzionamento del proxy di autenticazione Cloud SQL, consulta Informazioni sul proxy di autenticazione Cloud SQL.

I log di App Engine nella Google Cloud console possono fornire informazioni sugli errori di App Engine.

Esegui la pulizia

Al termine del tutorial, puoi liberare spazio eliminando le risorse che hai creato in modo che non utilizzino più la quota e non generino addebiti. Le seguenti sezioni descrivono come eliminare o disattivare queste risorse.

Elimina il progetto

Il modo più semplice per eliminare la fatturazione è quello di eliminare il progetto creato per il tutorial.

Per eliminare il progetto:

  1. In the Google Cloud console, go to the Manage resources page.

    Go to Manage resources

  2. In the project list, select the project that you want to delete, and then click Delete.
  3. In the dialog, type the project ID, and then click Shut down to delete the project.

Elimina le istanze

Per eliminare un'istanza Cloud SQL:

  1. In the Google Cloud console, go to the Instances page.

    Go to Instances

  2. Click the name of the SQL instance you that want to delete.
  3. To delete the instance, click Delete, and then follow the instructions.

Passaggi successivi