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.
Utilizzi Cloud SQL come database.
Utilizzi 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 o dei prodotti di sviluppo 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 piattaforma Cloud, 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 essere idonei a usufruire di una prova senza costi.

Prima di iniziare

Accedi al tuo Google Cloud account. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

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

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Installa gcloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

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

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Installa gcloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Crea un'istanza Cloud SQL di seconda generazione.
(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 del guestbook. Sebbene tu possa eseguire il deployment di phpMyAdmin da solo, probabilmente vorrai utilizzare lo con un'applicazione App Engine in uno scenario reale.

Scarica il codice sorgente di phpMyAdmin

Eseguirai il deployment di phpMyAdmin come servizio della tua applicazione App Engine, quindi devi scaricare il codice sorgente di phpMyAdmin. Segui questi passaggi:

In un terminale Cloud Shell, inserisci il seguente comando per scaricare il codice sorgente di 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 Download di phpMyAdmin.
Crea una nuova directory. Estrai i file in questa directory.
```
mkdir phpMyAdmin
```

Estrai i file dall'archivio nella nuova directory.

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

Prepara i file per il deployment

Per eseguire il deployment di phpMyAdmin, devi creare 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 in che modo i percorsi URL corrispondono ai gestori delle richieste e ai file statici. Contiene anche informazioni sul codice dell'applicazione, come l'ID applicazione e l'identificatore della versione più recente. Per creare il file:

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

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

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, esegui il deployment di phpMyAdmin come servizio di un'applicazione esistente e fornisci un nome per il servizio. Tuttavia, se non hai ancora eseguito il deployment di un'applicazione, devi utilizzare il nome del servizio "default". Questo è sufficiente ai fini di questo tutorial se stai provando phpMyAdmin su App Engine.

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

Crea `config.inc.php`

Per creare il file di configurazione di phpMyAdmin:

Crea un nuovo file denominato config.inc.php.
```
touch config.inc.php
```

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;

Apri Google Cloud Shell ed esegui il seguente comando per ottenere una stringa casuale per il tuo blowfish:
```
php -r "echo password_hash(uniqid(), PASSWORD_BCRYPT).PHP_EOL;"
```
Incolla il nuovo secret al posto di {{your_secret}} in config.inc.php.
Vai alla pagina Istanze Cloud SQL nella Google Cloud console.
Fai clic sull'istanza Cloud SQL per visualizzare la pagina dei dettagli dell'istanza.
Sostituisci il valore di {{your_connection_string}} (all'interno della $host variabile) con la Nome connessione istanza proprietà.
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:

Nella directory phpMyAdmin, crea il file.
```
touch php.ini
```

Modifica il file e aggiungi la seguente riga:

google_app_engine.enable_functions = "php_uname, getmypid"

Salva il file.

Esegui il deployment dell'applicazione

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

Verifica la disponibilità di aggiornamenti per i componenti gcloud.
```
gcloud components update
```
Esegui il deployment dell'applicazione eseguendo il seguente 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. L'esecuzione del deployment in un servizio separato contribuisce a garantire che phpMyAdmin venga eseguito nello stesso data center dell'applicazione principale, migliorando le prestazioni. Per scoprire di più sul deployment dell'app dalla riga di comando, consulta Eseguire il deployment di un'app PHP.

Accedi a phpMyAdmin

Ora puoi accedere a phpMyAdmin.

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
```
In Nome utente, inserisci root.
Inserisci la password root che hai fornito quando hai configurato l'account root.
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 ulteriori informazioni 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.

Libera spazio

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

Elimina il progetto

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

Per eliminare il progetto:

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per, le attività descritte in questo documento, eliminerai anche tutto il lavoro che hai svolto nel progetto.
Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

Nella Google Cloud console, vai alla pagina Gestisci risorse.
Vai a Gestisci risorse
Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
Nella finestra di dialogo, digita l'ID progetto e fai clic su Chiudi per eliminare il progetto.

Elimina le istanze

Per eliminare un'istanza Cloud SQL:

Nella Google Cloud console, vai alla Istanze pagina.
Vai a Istanze
Fai clic sul nome dell'istanza SQL che vuoi eliminare.
Per eliminare l'istanza, fai clic su Elimina, quindi segui le istruzioni.

Passaggi successivi

Scopri di più su phpMyAdmin.
Esplora architetture, diagrammi e best practice di riferimento su Google Cloud. Consulta il nostro Cloud Architecture Center.