1
1
# PHP Database library
2
2
3
- [](https://packagist.org/packages/josantonius/Database) [](https://packagist.org/packages/josantonius/Database) [](LICENSE) [](https://www.codacy.com/app/Josantonius/PHP-Database?utm_source=github.com&utm_medium=referral&utm_content=Josantonius/PHP-Database&utm_campaign=Badge_Grade) [](https://packagist.org/packages/josantonius/Database) [](https://travis-ci.org/Josantonius/PHP-Database) [](http://www.php-fig.org/psr/psr-2/) [](http://www.php-fig.org/psr/psr-4/) [](https://codecov.io/gh/Josantonius/PHP-Database)
3
+ [ ![ Latest Stable Version] ( https://poser.pugx.org/josantonius/Database/v/stable )] ( https://packagist.org/packages/josantonius/Database )
4
+ [ ![ License] ( https://poser.pugx.org/josantonius/Database/license )] ( LICENSE )
4
5
5
6
[ English version] ( README.md )
6
7
@@ -21,49 +22,46 @@ Biblioteca para la administración de bases de datos SQL para ser utilizada por
21
22
- [ DELETE] ( #delete )
22
23
- [ TRUNCATE TABLE] ( #truncate )
23
24
- [ DROP TABLE] ( #drop )
25
+ - [ Tipos de datos soportados para sentencias preparadas] ( #tipos-de-datos-soportados-para-sentencias-preparadas )
24
26
- [ Tests] ( #tests )
25
- - [ Tareas pendientes] ( #-tareas-pendientes )
26
- - [ Manejador de excepciones] ( #manejador-de-excepciones )
27
- - [ Contribuir] ( #contribuir )
28
- - [ Repositorio] ( #repositorio )
27
+ - [ Patrocinar] ( #patrocinar )
29
28
- [ Licencia] ( #licencia )
30
- - [ Copyright] ( #copyright )
31
29
32
30
---
33
31
34
32
## Requisitos
35
33
36
34
Esta clase es soportada por versiones de ** PHP 5.6** o superiores y es compatible con versiones de ** HHVM 3.0** o superiores.
37
35
38
- ## Instalación
36
+ ## Instalación
39
37
40
38
La mejor forma de instalar esta extensión es a través de [ Composer] ( http://getcomposer.org/download/ ) .
41
39
42
40
Para instalar ** PHP Database library** , simplemente escribe:
43
41
44
- $ composer require Josantonius/Database
42
+ composer require Josantonius/Database
45
43
46
44
El comando anterior sólo instalará los archivos necesarios, si prefieres ** descargar todo el código fuente** puedes utilizar:
47
45
48
- $ composer require Josantonius/Database --prefer-source
46
+ composer require Josantonius/Database --prefer-source
49
47
50
48
También puedes ** clonar el repositorio** completo con Git:
51
49
52
- $ git clone https://github.com/Josantonius/PHP-Database.git
50
+ git clone https://github.com/Josantonius/PHP-Database.git
53
51
54
52
O ** instalarlo manualmente** :
55
53
56
54
Descargar [ Database.php] ( https://raw.githubusercontent.com/Josantonius/PHP-Database/master/src/Database.php ) , [ Provider.php] ( https://raw.githubusercontent.com/Josantonius/PHP-Database/master/src/Provider/Provider.php ) , [ PDOprovider.php] ( https://raw.githubusercontent.com/Josantonius/PHP-Database/master/src/Provider/PDOprovider.php ) , [ MSSQLprovider.php] ( https://raw.githubusercontent.com/Josantonius/PHP-Database/master/src/Provider/MSSQLprovider.php ) and [ DBException.php] ( https://raw.githubusercontent.com/Josantonius/PHP-Database/master/src/Exception/DBException.php ) :
57
55
58
- $ wget https://raw.githubusercontent.com/Josantonius/PHP-Database/master/src/Database.php
59
- $ wget https://raw.githubusercontent.com/Josantonius/PHP-Database/master/src/Provider/Provider.php
60
- $ wget https://raw.githubusercontent.com/Josantonius/PHP-Database/master/src/Provider/PDOprovider.php
61
- $ wget https://raw.githubusercontent.com/Josantonius/PHP-Database/master/src/Provider/MSSQLprovider.php
62
- $ wget https://raw.githubusercontent.com/Josantonius/PHP-Database/master/src/Exception/DBException.php
56
+ wget https://raw.githubusercontent.com/Josantonius/PHP-Database/master/src/Database.php
57
+ wget https://raw.githubusercontent.com/Josantonius/PHP-Database/master/src/Provider/Provider.php
58
+ wget https://raw.githubusercontent.com/Josantonius/PHP-Database/master/src/Provider/PDOprovider.php
59
+ wget https://raw.githubusercontent.com/Josantonius/PHP-Database/master/src/Provider/MSSQLprovider.php
60
+ wget https://raw.githubusercontent.com/Josantonius/PHP-Database/master/src/Exception/DBException.php
63
61
64
62
## Get connection
65
63
66
- ### - Get connection:
64
+ ### - Get connection
67
65
68
66
``` php
69
67
Database::getConnection($id, $provider, $host, $user, $name, $password, $settings);
@@ -76,11 +74,11 @@ Database::getConnection($id, $provider, $host, $user, $name, $password, $setting
76
74
| $host | Host. | string | No | null |
77
75
| $user | Usuario. | string | No | null |
78
76
| $name | Nombre. | string | No | null |
79
- | $password | Password . | string | No | null |
77
+ | $password | Password. | string | No | null |
80
78
81
79
| Attribute | Key | Description | Type | Required | Default
82
80
| --- | --- | --- | --- | --- | --- |
83
- | $settings | | Opciones | array | No | null |
81
+ | $settings | | Opciones. Una vez realizada la conexión, esta configuración estará disponible en el objeto de conexión a la base de datos: $db->settings. | array | No | null |
84
82
| $settings | 'port' | Puerto. | string | No | |
85
83
| $settings | 'charset' | Charset. | string | No | |
86
84
@@ -116,7 +114,7 @@ $externalDB = Database::getConnection('external');
116
114
117
115
## Query
118
116
119
- ### - Procesar la consulta y prepararla para el proveedor:
117
+ ### - Procesar la consulta y prepararla para el proveedor
120
118
121
119
``` php
122
120
$db->query($query, $statements, $result);
@@ -161,7 +159,7 @@ $db->query(
161
159
162
160
## CREATE TABLE
163
161
164
- ### - CREATE TABLE:
162
+ ### - CREATE TABLE
165
163
166
164
``` php
167
165
$db->create($data)
@@ -220,7 +218,7 @@ $db->create($params)
220
218
221
219
## SELECT
222
220
223
- ### - Declaración SELECT:
221
+ ### - Declaración SELECT
224
222
225
223
``` php
226
224
$db->select($columns)
@@ -288,7 +286,7 @@ $db->select('name')
288
286
289
287
## INSERT INTO
290
288
291
- ### - Declaración INSERT INTO:
289
+ ### - Declaración INSERT INTO
292
290
293
291
``` php
294
292
$db->insert($data, $statements)
@@ -347,7 +345,7 @@ $db->insert($data, $statements)
347
345
348
346
## UPDATE
349
347
350
- ### - Declaración UPDATE:
348
+ ### - Declaración UPDATE
351
349
352
350
``` php
353
351
$db->update($data, $statements)
@@ -367,7 +365,7 @@ $db->update($data, $statements)
367
365
| | $statements | Declaraciones preparadas. | array | No | null |
368
366
| execute() | | Ejecutar consulta. | method | Sí | |
369
367
370
- ** # Return** (int) → número de filas afectadas
368
+ ** # Return** (int) → número de filas afectadas
371
369
372
370
``` php
373
371
#UPDATE ejemplo básico
@@ -438,7 +436,7 @@ $db->update($data, $statements['data'])
438
436
439
437
## REPLACE
440
438
441
- ### - Reemplazar una línea en una tabla si existe o insertar una nueva línea si no existe:
439
+ ### - Reemplazar una línea en una tabla si existe o insertar una nueva línea si no existe
442
440
443
441
``` php
444
442
$db->replace($data, $statements)
@@ -500,7 +498,7 @@ $db->replace($data, $statements)
500
498
501
499
## DELETE
502
500
503
- ### - Declaración DELETE:
501
+ ### - Declaración DELETE
504
502
505
503
``` php
506
504
$db->delete($data, $statements)
@@ -520,7 +518,7 @@ $db->delete($data, $statements)
520
518
| | $statements | Declaraciones preparadas. | array | No | null |
521
519
| execute() | | Ejecutar consulta. | method | Sí | |
522
520
523
- ** # Return** (int) → número de filas afectadas
521
+ ** # Return** (int) → número de filas afectadas
524
522
525
523
``` php
526
524
#DELETE all
@@ -567,7 +565,7 @@ $db->delete()
567
565
568
566
## TRUNCATE TABLE
569
567
570
- ### - Declaración TRUNCATE TABLE:
568
+ ### - Declaración TRUNCATE TABLE
571
569
572
570
``` php
573
571
$db->truncate()
@@ -591,7 +589,7 @@ $db->truncate()
591
589
592
590
## DROP TABLE
593
591
594
- ### - Declaración DROP TABLE:
592
+ ### - Declaración DROP TABLE
595
593
596
594
``` php
597
595
$db->drop()
@@ -613,70 +611,65 @@ $db->drop()
613
611
->execute();
614
612
```
615
613
616
- ## Tests
614
+ ## Tipos de datos soportados para sentencias preparadas
617
615
618
- Para ejecutar las [ pruebas ] ( tests ) necesitarás [ Composer ] ( http://getcomposer.org/download/ ) y seguir los siguientes pasos:
616
+ ### Booleano
619
617
620
- $ git clone https://github.com/Josantonius/PHP-Database.git
621
-
622
- $ cd PHP-Database
618
+ - bool
619
+ - boolean
623
620
624
- $ composer install
621
+ ### Nulo
625
622
626
- Ejecutar pruebas unitarias con [ PHPUnit ] ( https://phpunit.de/ ) :
623
+ - null
627
624
628
- $ composer phpunit
625
+ ### Números enteros
629
626
630
- Ejecutar pruebas de estándares de código [ PSR2] ( http://www.php-fig.org/psr/psr-2/ ) con [ PHPCS] ( https://github.com/squizlabs/PHP_CodeSniffer ) :
627
+ - int
628
+ - integer
631
629
632
- $ composer phpcs
630
+ ### Cadenas de texto
633
631
634
- Ejecutar pruebas con [ PHP Mess Detector] ( https://phpmd.org/ ) para detectar inconsistencias en el estilo de codificación:
632
+ - str
633
+ - string
635
634
636
- $ composer phpmd
635
+ ** Si algún tipo de dato no coincide con los anteriores, será validado como una cadena de texto. **
637
636
638
- Ejecutar todas las pruebas anteriores:
637
+ ** Si no se especifica ningún tipo de dato, el tipo de dato no será validado en la consulta preparada. **
639
638
640
- $ composer tests
639
+ ## Tests
641
640
642
- ## ☑ Tareas pendientes
641
+ Para ejecutar las [ pruebas ] ( tests ) necesitarás [ Composer ] ( http://getcomposer.org/download/ ) y seguir los siguientes pasos:
643
642
644
- - [ ] Añadir nueva funcionalidad.
645
- - [ ] Mejorar pruebas.
646
- - [ ] Mejorar documentación.
647
- - [ ] Refactorizar código para las reglas de estilo de código deshabilitadas. Ver [ phpmd.xml] ( phpmd.xml ) y [ .php_cs.dist] ( .php_cs.dist ) .
643
+ git clone https://github.com/Josantonius/PHP-Database.git
644
+
645
+ cd PHP-Database
648
646
649
- ## Manejador de excepciones
647
+ composer install
650
648
651
- Esta biblioteca utiliza [ control de excepciones ] ( src/Exception ) que puedes personalizar a tu gusto.
649
+ Ejecutar pruebas unitarias con [ PHPUnit ] ( https://phpunit.de/ ) :
652
650
653
- ## Contribuir
651
+ composer phpunit
654
652
655
- Si deseas colaborar, puedes echar un vistazo a la lista de
656
- [ issues] ( https://github.com/Josantonius/PHP-Database/issues ) o [ tareas pendientes] ( #-tareas-pendientes ) .
653
+ Ejecutar pruebas de estándares de código [ PSR2] ( http://www.php-fig.org/psr/psr-2/ ) con [ PHPCS] ( https://github.com/squizlabs/PHP_CodeSniffer ) :
657
654
658
- ** Pull requests **
655
+ composer phpcs
659
656
660
- * [ Fork and clone] ( https://help.github.com/articles/fork-a-repo ) .
661
- * Ejecuta el comando ` composer install ` para instalar dependencias.
662
- Esto también instalará las [ dependencias de desarrollo] ( https://getcomposer.org/doc/03-cli.md#install ) .
663
- * Ejecuta el comando ` composer fix ` para estandarizar el código.
664
- * Ejecuta las [ pruebas] ( #tests ) .
665
- * Crea una nueva rama (** branch** ), ** commit** , ** push** y envíame un
666
- [ pull request] ( https://help.github.com/articles/using-pull-requests ) .
657
+ Ejecutar pruebas con [ PHP Mess Detector] ( https://phpmd.org/ ) para detectar inconsistencias en el estilo de codificación:
667
658
668
- ## Repositorio
659
+ composer phpmd
669
660
670
- La estructura de archivos de este repositorio se creó con [ PHP-Skeleton ] ( https://github.com/Josantonius/PHP-Skeleton ) .
661
+ Ejecutar todas las pruebas anteriores:
671
662
672
- ## Licencia
663
+ composer tests
673
664
674
- Este proyecto está licenciado bajo ** licencia MIT ** . Consulta el archivo [ LICENSE ] ( LICENSE ) para más información.
665
+ ## Patrocinar
675
666
676
- ## Copyright
667
+ Si este proyecto te ayuda a reducir el tiempo de desarrollo,
668
+ [ puedes patrocinarme] ( https://github.com/josantonius/lang/es-ES/README.md#patrocinar )
669
+ para apoyar mi trabajo :blush :
677
670
678
- 2017 - 2018 Josantonius, [ josantonius.com ] ( https://josantonius.com/ )
671
+ ## Licencia
679
672
680
- Si te ha resultado útil, házmelo saber : wink :
673
+ Este repositorio tiene una licencia [ MIT License ] ( LICENSE ) .
681
674
682
- Puedes contactarme en [ Twitter ] ( https://twitter .com/Josantonius ) o a través de mi [ correo electrónico ] ( mailto:hello@ josantonius.com ) .
675
+ Copyright © 2017-2022, [ Josantonius ] ( https://github .com/josantonius/lang/es-ES/README.md#contacto )
0 commit comments