MySQL: Pierwsze kroki

Jak rozpocząć pracę z MySQL

👋 Witamy w dokumentacji Stackhero!

Stackhero oferuje gotowe do użycia rozwiązanie MySQL cloud, które zapewnia wiele korzyści, w tym:

  • Nieograniczone połączenia i transfery.
  • Włączony interfejs webowy phpMyAdmin.
  • Łatwe aktualizacje za pomocą jednego kliknięcia.
  • Optymalna wydajność i solidne zabezpieczenia dzięki prywatnej i dedykowanej VM.

Oszczędzaj czas i upraszczaj swoje życie: wypróbowanie rozwiązania MySQL cloud hosting Stackhero zajmuje tylko 5 minut!

Adresy URL MySQL

Jeśli potrzebujesz szybkiego sposobu na połączenie się z usługą MySQL, możesz skorzystać z formatu URL MySQL, o ile Twój sterownik go obsługuje:

mysql://root:<ROOT_PASSWORD>@<XXXXXX>.stackhero-network.com:<PORT>/root?useSSL=true&requireSSL=true

Jeśli pracujesz z Ruby, format URL jest nieco inny:

mysql2://root:<ROOT_PASSWORD>@<XXXXXX>.stackhero-network.com:<PORT>/root?reconnect=true&useSSL=true&requireSSL=true

Używanie MySQL z PHP

MySQLi (styl obiektowy)

Poniżej znajduje się przykład połączenia z MySQL w PHP przy użyciu rozszerzenia MySQLi w stylu obiektowym:

<?php

$hostname = '<XXXXXX>.stackhero-network.com';
$port = '<PORT>';
$user = 'root';
$password = '<ROOT_PASSWORD>';
$database = 'root'; // Chociaż ten przykład używa bazy "root", zaleca się utworzenie osobnej bazy i użytkownika dla swojej aplikacji przez phpMyAdmin.

$mysqli = mysqli_init();
$mysqliConnected = $mysqli->real_connect($hostname, $user, $password, $database, $port, NULL, MYSQLI_CLIENT_SSL);
if (!$mysqliConnected) {
  die("Błąd połączenia: " . $mysqli->connect_error);
}

echo 'Połączenie udane... ' . $mysqli->host_info . "\n";

$mysqli->close();

?>

MySQLi (styl proceduralny)

Jeśli preferujesz kod proceduralny, poniżej znajdziesz sposób połączenia z MySQLi w tym stylu:

<?php

$hostname = '<XXXXXX>.stackhero-network.com';
$port = '<PORT>';
$user = 'root';
$password = '<ROOT_PASSWORD>';
$database = 'root'; // Dla bezpieczeństwa utwórz dedykowaną bazę i użytkownika w phpMyAdmin zamiast używać "root".

$mysqli = mysqli_init();
$mysqliConnected = mysqli_real_connect($mysqli, $hostname, $user, $password, $database, $port, NULL, MYSQLI_CLIENT_SSL);
if (!$mysqliConnected) {
  die("Błąd połączenia: " . mysqli_connect_error($mysqli));
}

echo 'Sukces: ' . mysqli_get_host_info($mysqli) . "\n";

mysqli_close($mysqli);

?>

PDO

Jeśli preferujesz PDO do obsługi bazy danych, poniżej znajdziesz przykładową konfigurację połączenia:

<?php

$hostname = '<XXXXXX>.stackhero-network.com';
$port = '<PORT>';
$user = 'root';
$password = '<ROOT_PASSWORD>';
$database = 'root'; // Najlepiej utworzyć dedykowaną bazę i użytkownika dla swojej aplikacji.

$dsn = "mysql:host=$hostname;port=$port;dbname=$database";

$options = array(
  // Jeśli pojawiają się błędy związane z SSL podczas połączenia, upewnij się, że w systemie są zainstalowane odpowiednie certyfikaty CA (patrz poniżej).
  PDO::MYSQL_ATTR_SSL_CAPATH => '/etc/ssl/certs/',
  // PDO::MYSQL_ATTR_SSL_CA => 'isrgrootx1.pem',
  PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT => true,
);

$pdo = new PDO($dsn, $user, $password, $options);

$stm = $pdo->query("SELECT VERSION()");
$version = $stm->fetch();

echo "Połączono z bazą danych w wersji " . $version[0] . "\n";

?>

Rozwiązywanie problemów: SSL operation failed with code 1

Jeśli pojawi się błąd taki jak:

Uncaught PDOException: PDO::__construct(): SSL operation failed with code 1. OpenSSL Error messages: error:0A000086:SSL routines::certificate verify failed

Prawdopodobnie w systemie brakuje certyfikatów CA w katalogu /etc/ssl/certs/.

Jeśli masz dostęp do systemu, na którym działa Twój kod PHP, możesz dodać certyfikaty w następujący sposób:

  1. Na Ubuntu/Debian: sudo apt-get install ca-certificates
  2. Na Alpine Linux: apk add ca-certificates

Jeśli nie masz bezpośredniego dostępu, możesz dodać certyfikat ręcznie:

  1. Pobierz certyfikat: https://letsencrypt.org/certs/isrgrootx1.pem
  2. Umieść plik isrgrootx1.pem w swoim projekcie PHP.
  3. Zakomentuj linię PDO::MYSQL_ATTR_SSL_CAPATH => '/etc/ssl/certs/'
  4. Odkomentuj linię PDO::MYSQL_ATTR_SSL_CA => 'isrgrootx1.pem'

Rozwiązywanie: błędy niezdefiniowanych stałych z PDO

Jeśli pojawią się błędy takie jak:

Fatal error: Uncaught Error: Undefined constant PDO::MYSQL_ATTR_SSL_CAPATH

lub podobne komunikaty, oznacza to, że PDO zostało zainstalowane bez wsparcia dla MySQL.

  1. Na Ubuntu/Debian

Możesz dodać wymaganą rozszerzenie poleceniem:

sudo apt-get install php-mysql
  1. W Dockerze

Jeśli korzystasz z Dockera, upewnij się, że wsparcie dla MySQL jest dodane podczas budowania obrazu. Dodaj do swojego Dockerfile:

RUN docker-php-ext-install pdo pdo_mysql


### Używanie MySQL z Symfony i Doctrine

Jeśli pracujesz z Symfony i Doctrine, możesz skonfigurować połączenie w następujący sposób:

1. Edytuj plik `.env` i ustaw zmienną `DATABASE_URL`:

DATABASE_URL="mysql://<USER>:<PASSWORD>@<XXXXXX>.stackhero-network.com:<PORT>/<DATABASE>"


1. Następnie w pliku `config/packages/doctrine.yaml` ustaw driver i opcje:

```yaml
doctrine:
    dbal:
        url: '%env(resolve:DATABASE_URL)%'
        driver: 'pdo_mysql'
        options:
            # PDO::MYSQL_ATTR_SSL_CAPATH
            1010: '/etc/ssl/certs'
            # PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT
            1014: true

Rozwiązywanie problemów: SSL operation failed with code 1

Jeśli pojawi się błąd taki jak:

Uncaught PDOException: PDO::__construct(): SSL operation failed with code 1. OpenSSL Error messages: error:0A000086:SSL routines::certificate verify failed

Prawdopodobnie katalog /etc/ssl/certs/ nie zawiera certyfikatów CA.

Jeśli masz dostęp do systemu, możesz je zainstalować następująco:

  1. Na Ubuntu/Debian: sudo apt-get install ca-certificates
  2. Na Alpine Linux: apk add ca-certificates

Jeśli nie masz bezpośredniego dostępu, możesz dodać certyfikat ręcznie:

  1. Pobierz: https://letsencrypt.org/certs/isrgrootx1.pem
  2. Umieść isrgrootx1.pem w swoim projekcie Symfony.
  3. Zaktualizuj config/packages/doctrine.yaml:
doctrine:
    dbal:
        url: '%env(resolve:DATABASE_URL)%'
        driver: 'pdo_mysql'
        options:
            # PDO::MYSQL_ATTR_SSL_CA
            1009: 'isrgrootx1.pem'
            # PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT
            1014: true

Używanie MySQL z Laravel

Aby skonfigurować MySQL w Laravel, otwórz plik config/database.php i zaktualizuj sekcję MySQL:

'mysql' => [
  'driver' => 'mysql',
  'host' => env('STACKHERO_MYSQL_HOST'),
  'port' => env('STACKHERO_MYSQL_PORT'),
  'username' => env('STACKHERO_MYSQL_USER'),
  'password' => env('STACKHERO_MYSQL_PASSWORD'),
  'database' => env('STACKHERO_MYSQL_USER'),
  'charset' => 'utf8mb4',
  'collation' => 'utf8mb4_unicode_ci',
  'prefix' => '',
  'prefix_indexes' => true,
  'strict' => true,
  'engine' => null,
  'sslmode' => 'require',
  'options' => extension_loaded('pdo_mysql')
    ? array_filter([
      // W przypadku błędów SSL zobacz sekcję rozwiązywania problemów powyżej.
      PDO::MYSQL_ATTR_SSL_CAPATH => '/etc/ssl/certs/',
      // PDO::MYSQL_ATTR_SSL_CA => 'isrgrootx1.pem',
      PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT => true,
    ])
    : [],
],

Używanie MySQL z PHP CodeIgniter

W pliku konfiguracyjnym database.php możesz dodać:

$db['default'] = array(
  'hostname' => getenv('STACKHERO_MYSQL_HOST'),
  'port'     => getenv('STACKHERO_MYSQL_PORT'),
  'username' => getenv('STACKHERO_MYSQL_USER'),
  'password' => getenv('STACKHERO_MYSQL_PASSWORD'),
  'database' => getenv('STACKHERO_MYSQL_USER'), // Zgodnie z konwencją nazwa bazy odpowiada użytkownikowi.
  'dbdriver' => 'mysqli',
  'dbprefix' => '',
  'pconnect' => true,
  'char_set' => 'utf8',
  'dbcollat' => 'utf8_general_ci',
  'encrypt'  => array() // Ważne: włącz szyfrowanie TLS
);

Połączenie przez zmienne środowiskowe w PHP

Zazwyczaj bezpieczniej jest nie przechowywać danych dostępowych do bazy w kodzie. Zamiast tego możesz użyć zmiennych środowiskowych. Oto jak je pobrać:

$hostname = getenv('STACKHERO_MYSQL_HOST');
$port = getenv('STACKHERO_MYSQL_PORT');
$user = getenv('STACKHERO_MYSQL_USER');
$password = getenv('STACKHERO_MYSQL_PASSWORD');
$database = getenv('STACKHERO_MYSQL_USER'); // Zgodnie z konwencją nazwa bazy odpowiada użytkownikowi.

Używanie MySQL z WordPress

Podłączenie WordPressa do Stackhero for MySQL jest proste. Wystarczy edytować plik wp-config.php w następujący sposób:

define('DB_HOST', '<XXXXXX>.stackhero-network.com');
define('DB_PORT', '<PORT>');
define('DB_NAME', 'root');
define('DB_USER', 'root');
define('DB_PASSWORD', '<yourPassword>');

// Włącz szyfrowanie TLS (znane także jako SSL)
define('MYSQL_CLIENT_FLAGS', MYSQLI_CLIENT_SSL);

Kluczowym krokiem jest włączenie szyfrowania TLS (SSL). Bez tego połączenie nie będzie działać prawidłowo.

Używanie MySQL z Node.js

Protokół MySQL X (pakiet xdevapi)

Aby użyć protokołu MySQL X, zainstaluj oficjalny pakiet xdevapi:

npm install @mysql/xdevapi

Przykładowy skrypt:

const mysqlx = require('@mysql/xdevapi');

(async () => {
  // Połączenie z MySQL przez protokół MySQL X
  const session = await mysqlx.getSession({
    host: '<XXXXXX>.stackhero-network.com',
    port: '<PORT>',
    user: 'root',
    password: '<ROOT_PASSWORD>'
  });

  // Utwórz schemat (bazę), jeśli nie istnieje
  const schemaExists = await session.getSchema('stackherotest').existsInDatabase();
  if (!schemaExists) {
    await session.createSchema('stackherotest');
  }

  // Utwórz tabelę 'users', jeśli nie istnieje
  const tableExists = await session
    .getSchema('stackherotest')
    .getTable('users')
    .existsInDatabase();
  if (!tableExists) {
    await session
      .sql('CREATE TABLE `stackherotest`.`users` '
        + '('
        + '`userId` INT UNSIGNED NOT NULL,'
        + '`name` VARCHAR(128) NOT NULL,'
        + '`address` TEXT NOT NULL,'
        + '`email` VARCHAR(265) NOT NULL'
        + ') '
        + 'ENGINE = InnoDB;')
      .execute();
  }

  // Wstaw przykładowego użytkownika
  await session
    .getSchema('stackherotest')
    .getTable('users')
    .insert('userId', 'name', 'address', 'email')
    .values(
      Math.round(Math.random() * 100000),
      'User name',
      'User address',
      '[email protected]'
    )
    .execute();

  // Policz liczbę użytkowników
  const usersCount = await session
    .getSchema('stackherotest')
    .getTable('users')
    .count();

  console.log(`Obecnie w tabeli "users" jest ${usersCount} wpisów`);

  // Zamknij połączenie
  await session.close();

})().catch(error => {
  console.error('');
  console.error('Wystąpił błąd!');
  console.error(error);
  process.exit(1);
});

Protokół MySQL (pakiet mysql2)

Jeśli preferujesz klasyczny protokół, możesz użyć pakietu mysql2 z obsługą Promise. Zainstaluj go poleceniem:

npm install mysql2

Przykład użycia:

const mysql = require('mysql2/promise');

(async () => {
  const db = await mysql.createConnection({
    host: '<XXXXXX>.stackhero-network.com',
    port: '<PORT>',
    user: 'root',
    password: '<ROOT_PASSWORD>'
  });

  // Utwórz bazę, jeśli potrzeba
  await db.query('CREATE DATABASE IF NOT EXISTS stackherotest');

  // Utwórz tabelę, jeśli potrzeba
  await db.query('CREATE TABLE IF NOT EXISTS `stackherotest`.`users` '
    + '('
    + '`userId` INT UNSIGNED NOT NULL,'
    + '`name` VARCHAR(128) NOT NULL,'
    + '`address` TEXT NOT NULL,'
    + '`email` VARCHAR(265) NOT NULL'
    + ') '
    + 'ENGINE = InnoDB;');

  // Wstaw przykładowego użytkownika
  await db.query(
    'INSERT INTO `stackherotest`.`users` (`userId`, `name`, `address`, `email`) VALUES ?',
    [
      [
        Math.round(Math.random() * 100000),
        'User name',
        'User address',
        '[email protected]'
      ]
    ]
  );

  // Policz użytkowników
  const [ usersCount ] = await db.query('SELECT COUNT(*) AS `cpt` FROM `stackherotest`.`users`');
  console.log(`Obecnie w tabeli "users" jest ${usersCount[0].cpt} wpisów`);

  // Zamknij połączenie
  await db.end();

})().catch(error => {
  console.error('');
  console.error('Wystąpił błąd!');
  console.error(error);
  process.exit(1);
});

Używanie MySQL z Node.js, NestJS lub TypeORM

Aby połączyć się z Node.js, NestJS lub TypeORM, możesz dodać opcję ssl jak poniżej:

TypeOrmModule.forRoot({
  type: 'mysql',
  host: '<XXXXXX>.stackhero-network.com',
  port: <PORT>,
  username: 'root',
  password: '<ROOT_PASSWORD>',
  database: 'root',
  entities: [],
  synchronize: true,
  ssl: {}
});

Używanie MySQL z Prisma

Jeśli korzystasz z Prisma, dodanie opcji sslaccept=strict zapewni szyfrowane połączenie. Przykładowa konfiguracja:

datasource db {
  provider = "mysql"
  url = "mysql://root:<ROOT_PASSWORD>@<XXXXXX>.stackhero-network.com:<PORT>/root?sslaccept=strict"
}

Używanie MySQL z Django

Jeśli nie masz jeszcze zainstalowanego modułu mysqlclient, możesz to zrobić poleceniem:

pip install mysqlclient

Jeśli podczas instalacji pojawi się błąd Exception: Can not find valid pkg-config name, może być konieczne doinstalowanie pakietu libmysqlclient. Na Ubuntu/Debian: apt-get update && apt-get install --no-install-recommends -y libmysqlclient-dev

Na początku możesz przetestować połączenie, przechowując hasło bezpośrednio w pliku settings.py. Jednak dla bezpieczeństwa w dłuższej perspektywie najlepiej używać zmiennych środowiskowych (patrz poniżej).

Edytuj plik settings.py w następujący sposób:

DATABASES = {
  'default': {
    'ENGINE': 'django.db.backends.mysql',
    'HOST': '<XXXXXX>.stackhero-network.com',
    'PORT': '<PORT>',
    'OPTIONS': {
      'ssl_mode': 'REQUIRED',
    },
    'NAME': 'root',
    'USER': 'root',
    'PASSWORD': '<ROOT_PASSWORD>'
  }
}

Uwaga: ten przykład służy wyłącznie do testów i nie jest zalecany do środowisk produkcyjnych!

Po potwierdzeniu, że połączenie działa, możesz przejść na bezpieczniejsze rozwiązanie z użyciem django-environ do zarządzania zmiennymi środowiskowymi.

Najpierw zainstaluj pakiet:

pip install django-environ

Następnie zaktualizuj swój plik settings.py:

import environ
env = environ.Env()
environ.Env.read_env()

DATABASES = {
  'default': {
    'ENGINE': 'django.db.backends.mysql',
    'HOST': env('STACKHERO_MYSQL_HOST'),
    'PORT': env('STACKHERO_MYSQL_PORT'),
    'OPTIONS': {
      'ssl_mode': 'REQUIRED',
    },
    'NAME': 'root',
    'USER': 'root',
    'PASSWORD': env('STACKHERO_MYSQL_ROOT_PASSWORD')
  }
}

Utwórz lub edytuj plik .env w tym samym katalogu co settings.py i dodaj:

STACKHERO_MYSQL_HOST=<XXXXXX>.stackhero-network.com
STACKHERO_MYSQL_PORT=<PORT>
STACKHERO_MYSQL_ROOT_PASSWORD=<ROOT_PASSWORD>

Aby zabezpieczyć dane dostępowe, dodaj .env do pliku .gitignore:

echo ".env" >> .gitignore

Połączenie MySQL z Java/Spring

Aby połączyć aplikację Spring, ustaw zmienną środowiskową SPRING_DATASOURCE_URL z adresem URL bazy danych, pamiętając o prefiksie jdbc::

SPRING_DATASOURCE_URL=jdbc:mysql://root:<ROOT_PASSWORD>@<XXXXXX>.stackhero-network.com:<PORT>/root?useSSL=true&requireSSL=true

Połączenie MySQL z Groovy/Grails

Poniżej przykład konfiguracji aplikacji Grails do połączenia z MySQL:

dataSource {
  pooled = true
  driverClassName = "com.mysql.cj.jdbc.Driver"
  dialect = org.hibernate.dialect.MySQL8Dialect
  // Właściwości związane z SSL
  properties {
    useSSL = true
    requireSSL = true
    verifyServerCertificate = true
    sslMode = "REQUIRED"
  }
}

environments {
  production {
    dataSource {
      dbCreate = "none"
      url = "jdbc:mysql://" + System.env.STACKHERO_MYSQL_HOST + ":" + System.env.STACKHERO_MYSQL_PORT + "/root?useSSL=true&requireSSL=true&verifyServerCertificate=true&sslMode=required" // Możesz zamienić "/root" na wybraną bazę.
      username = "root" // Zaleca się utworzenie dedykowanego użytkownika dla aplikacji.
      password = System.env.STACKHERO_MYSQL_ROOT_PASSWORD
      properties {
        maxActive = 50
        minEvictableIdleTimeMillis = 1800000
        timeBetweenEvictionRunsMillis = 1800000
        numTestsPerEvictionRun = 3
        testOnBorrow = true
        testWhileIdle = true
        testOnReturn = false
        validationQuery = "SELECT 1"
      }
    }
  }
}

Tworzenie użytkownika MySQL przez phpMyAdmin

Dla lepszego bezpieczeństwa zaleca się utworzenie dedykowanego użytkownika dla swojej aplikacji zamiast korzystania z użytkownika "root". Możesz to zrobić łatwo przez phpMyAdmin:

  1. W phpMyAdmin wybierz User accounts z górnego menu.

  2. Kliknij Add user account.

  3. Wypełnij formularz tworzenia użytkownika:

    • Podaj nazwę konta (najczęściej nazwę aplikacji)
    • Kliknij Generate password, aby wygenerować bezpieczne hasło i skopiuj je do schowka
    • Zaznacz Create database with same name and grant all privileges

Po zatwierdzeniu formularza otrzymasz nowego użytkownika oraz dedykowaną bazę danych o tej samej nazwie co nazwa użytkownika.

Inne artykuły dotyczące MySQL

  1. Wprowadzenie
    Wprowadzenie do MySQL
  2. Zaawansowane użycie
    Jak konfigurować, optymalizować, eksportować lub importować dane MySQL
  3. Konfigurowanie GUI
    Jak połączyć interfejsy graficzne z MySQL
  4. Rozwiązywanie problemów
    Typowe problemy i rozwiązania dla MySQL
  5. Workbench
    Jak skonfigurować MySQL Workbench