Cómo ser eficiente en PhpStorm: un IDE que realmente importa

¿Qué significa ser un buen desarrollador de software?

Primero, requiere un conocimiento profundo de la pila tecnológica particular en la que está trabajando. Si es un desarrollador LAMP, sin duda necesita ser un experto en PHP y MySQL, conocer marcos modernos y tener algunas habilidades decentes en la administración de Linux.

En segundo lugar, pero no menos importante, está el conocimiento práctico de las herramientas complementarias que utiliza todos los días en su flujo de trabajo.

Debe poder trabajar correctamente con sistemas de control de versiones, herramientas de integración continua, servicios de administración de máquinas virtuales (como Vagrant) y, obviamente, su entorno de desarrollo integrado (IDE).

Este artículo cubre el popular y robusto IntelliJ IDEA IDE PhpStorm y cómo, con un poco de esfuerzo, puede duplicar fácilmente su eficiencia e incluso prevenir errores mientras codifica.

Entrénate con atajos de teclado

Comencemos con la habilidad más simple y quizás la más importante para cualquier IDE: el uso adecuado del teclado.

Si compara a un programador experimentado con un usuario normal de PC, lo primero que notará es que el programador pasa casi todo su tiempo usando un teclado y casi nunca toca el mouse. Hay una razón para eso: es mucho más eficiente.

Primero, conviértete en un buen mecanógrafo

Si bien escribir no está conectado directamente con las habilidades de IDE, los atajos son inútiles si necesita mirar su teclado para encontrar cada tecla.

Si aún no está escribiendo al menos 50 palabras por minuto (WPM), busque un sitio web de capacitación en mecanografía al tacto, como TypingClub.com, y aumente su velocidad.

También hay sitios web de mecanografía competitivos, como TypingRaces.com, donde puedes competir con otras personas en mecanografía. ¿Mi recomendación? Participe en una carrera como calentamiento matutino todos los días.

Entrénese para usar los accesos directos de PhpStorm

La forma más rápida de aprender es no darse una alternativa a los atajos de teclado.

Cuando estaba estudiando atajos, apagué todos los menús, pestañas, barras de navegación, etc. También puede hacerlo navegando al menú Ver y desmarcando todas las marcas (es posible que desee dejar la 'Barra de estado'):

Mi IDE ahora se ve así:

Como puede ver, no puedo evitar usar atajos, incluso si quisiera.

Me tomó alrededor de tres o cuatro días de sufrimiento superar las etapas de ajuste de la computadora portátil.

Si encuentra que su motivación decae, PhpStorm tiene una guía de productividad incorporada. Contiene una lista de características y estadísticas de uso para cada una de ellas. Simplemente haga clic en 'Ayuda', luego en 'Guía de productividad' y verá algo como esto:

Como puede ver, los atajos me salvaron de escribir más de 20 000 caracteres adicionales (en el transcurso de seis meses) y evitaron alrededor de 1000 errores. ¡Bastante motivador!

También me dice qué características no uso muy a menudo, identificando lugares donde puedo mejorar mis habilidades de acceso directo. Revise sus estadísticas y use el conocimiento sabiamente.

Principales atajos de teclado

Jetbrains proporciona un práctico PDF con todos los accesos directos disponibles enumerados en su documentación oficial y, además, tiene una lista de 'Accesos directos de teclado que no puede perderse'. Comienza a aprender esto de inmediato, hasta que puedas hacerlo mientras duermes.

De lejos, mis atajos favoritos son:

• Ctrl+ E - alternar entre archivos usados ​​recientemente
• Ctrl + / - comentar/descomentar un bloque de código
• Ctrl + B - ir a la declaración de clase
• Ctrl + N - navegar a la clase
• Ctrl + R - buscar y reemplazar
• Ctrl +Alt + L - reformatear código
• Alt + Enter : muestra acciones de intención y arreglos rápidos
• Ctrl + Shift + Enter - declaración completa

Algunos de estos se explican por sí mismos, a otros les vendría bien un poco más de cobertura.

Cambiando archivos con Ctrl + E y Enter

Imagine que necesita cambiar con frecuencia entre dos archivos, por ejemplo, entre una clase de PHP con la lógica empresarial de su aplicación y una plantilla, que se utiliza para representarla y generarla.

Muchos desarrolladores cambiarían del teclado al mouse, navegarían a una pestaña con el archivo, harían clic en él y encontrarían la parte necesaria con una rueda de desplazamiento. El problema: ¡Es extremadamente lento!

¿No es mejor presionar Ctrl+E y luego Enter?

Ctrl+E le mostrará una lista de archivos usados ​​recientemente, y si presiona Enter de inmediato, cambiará al archivo usado justo antes del actual.

Si desea regresar, simplemente presione la misma secuencia nuevamente.

Esta es la forma más rápida de alternar entre dos archivos, ¡con solo tres pulsaciones de teclas! Imagínese cuánto tiempo ahorrará, cuando tenga que hacer esto cientos de veces al día.

Mostrar acciones de intención y arreglos rápidos con Alt+Enter

Cualquier IDE moderno destaca los errores y proporciona algunas sugerencias para mejorar el código. Si mueve el cursor a cualquier parte incompleta o sin documentar de un código, verá un icono de bombilla y, si hace clic en él, verá un menú emergente de posibles acciones.

La misma acción se puede realizar presionando Alt+Enter , lo cual es mucho más conveniente.

En el caso de la captura de pantalla anterior, PhpStorm ofrece dos opciones: Agregar una especificación de PHPDoc a la función (lo cual es un muy buen consejo, permanezca atento) y elimine un parámetro no utilizado.

El mismo atajo se puede usar para muchas otras acciones comunes: crear getters y setters para propiedades de clase, inicializar campos en constructores, agregar métodos y propiedades no definidos, etc.

Completar declaraciones con Ctrl+Shift+Enter

Este atajo es muy sencillo y extremadamente útil al mismo tiempo, hace exactamente lo que dice.

Por ejemplo, si escribe $i = 0 y luego presiona Ctrl+Shift+Enter inmediatamente después, PhpStorm agregará un punto y coma a su expresión. Si escribe if y el atajo después, PhpStorm agregará corchetes, y así sucesivamente.

Utilice este acceso directo con la mayor frecuencia posible. Le ahorrará mucho tiempo ya que todo el código consta de estructuras estándar. ¡Cualquier aumento de velocidad en la escritura de estructuras hace que escribir el código sea mucho más rápido también!

El complemento IdeaVim

El uso de accesos directos puede aumentar drásticamente su productividad, pero si no es suficiente para usted, el siguiente nivel es el complemento IdeaVim.

Como probablemente sepa, Vim es un editor de texto de consola ampliamente utilizado por los geeks de Linux y los ingenieros devops para administrar servidores remotos a través de la línea de comandos.

Vim tiene dos características importantes.

Primero, es difícil de aprender. En segundo lugar, si lo conoce bien, vale la pena. Su productividad en la edición de texto será mucho mejor que con cualquier editor de GUI. También habrá situaciones en su carrera en las que no tenga más remedio que usar un editor de consola, como Vim, (si necesita arreglar algo en un servidor web remoto y solo tiene acceso a la consola, por ejemplo).

Pero, ¿cómo se relaciona Vim con PhpStorm?

Bueno, muchos desarrolladores quieren combinar la eficiencia de Vim con las características de un IDE moderno (por ejemplo, finalización de código, búsqueda de clases, búsqueda avanzada y navegación). Para ello se creó el complemento IdeaVim.

Nota importante: De aquí en adelante, asumo que conoces los conceptos básicos de Vim. Si no lo hace, puede comenzar a usar Vim con vimtutor, al que se puede acceder en casi todas las distribuciones de Linux o en Openvim.

Instalación del complemento

1. Vaya a 'Archivo', luego a 'Configuración', luego a 'Complementos' y escriba IdeaVim en el cuadro de búsqueda de complementos. Marque la casilla de verificación a la derecha del nombre del complemento y haga clic en "Aplicar". 2. Reinicie PhpStorm. 3. Encienda el complemento marcando 'Herramientas' y luego 'Emulador de Vim'

4. Los accesos directos originales de PhpStorm y los accesos directos de Vim (habilitados por el complemento) pueden entrar en conflicto entre sí, por lo que debe resolver estos conflictos manualmente. Vaya a 'Archivo', 'Configuración', 'Otras configuraciones', luego 'Emulación de Vim'. Verá la lista de accesos directos en conflicto. En esta lista, puede elegir si usar el acceso directo de PhpStorm o el acceso directo de Vim vinculado a esa secuencia de teclas. Puede ver mis opciones actuales en la captura de pantalla a continuación. Si no puede tomar una decisión, simplemente deje un atajo sin definir; PhpStorm le pedirá que elija cuándo lo usa por primera vez.

Uso de complementos

Después de activar el complemento, notará inmediatamente que el área de edición se vuelve similar a Vim:

• El cursor cambió su forma y se volvió rectangular, como en Vim.
• Si intenta escribir algo en el editor, no pasará nada.

Desde este punto, puede comenzar a editar sus archivos exactamente como lo haría en Vim, usando las teclas h , j , k , l para navegar y la tecla i para cambiar entre el modo normal y el modo de inserción, etc.

Casi todos los accesos directos de Vim son compatibles con el complemento.

Simultáneamente, todas las características del IDE siguen presentes, por lo que puede editar el texto extremadamente rápido, usando solo su teclado (como en Vim), y aún así saltar entre clases, archivos, usos y definiciones (como en un flujo de trabajo moderno de PhpStorm).

Búsqueda Avanzada

Una de las mejores ventajas de cualquier IDE sobre los editores de texto ordinarios es la capacidad de implementar una búsqueda avanzada.

Puede parecer redundante, si ha trabajado solo con proyectos pequeños, pero cuando comience a trabajar con una gran base de código, con complicadas relaciones OOP entre clases, comprenderá lo indispensable que es.

Es fácil encontrar una cadena en particular en un archivo mediante una búsqueda común ( Ctrl + F ) o buscar y reemplazar ( Ctrl + R ), pero ¿qué sucede si necesita encontrar una definición de una clase en particular en miles de archivos? ¿O si desea encontrar un método particular en una clase que contiene miles de líneas de código? ¿O tal vez desea excluir todos los comentarios de los resultados de recuperación? Ahí es donde ayuda un IDE moderno como PhpStorm.

En esta sección, le mostraré las variantes de búsqueda más útiles en PhpStorm.

Buscar en ruta

Después de la búsqueda ordinaria, la búsqueda más fácil es una cadena en particular en todos los archivos en alguna subcarpeta del proyecto. Se implementa tan fácilmente en PhpStorm que lo uso con mucha más frecuencia que cualquier otra opción de búsqueda.

Por ejemplo, busque usos de una clase User en mi aplicación de ejemplo.

1. Pulse Ctrl + Shift + F Verá una ventana emergente con opciones de búsqueda. Escriba ' User ' en la cadena de consulta. Verá una serie de resultados en una pestaña Vista previa:

2. Ahora, podemos cambiar a la pestaña Vista previa y encontrar manualmente los resultados necesarios allí, pero tenemos más de 100 coincidencias. ¡Tedioso! Seamos más específicos.

En primer lugar, estamos buscando los usos de la clase, así que marquemos la opción "solo palabras completas". Nos ayudará a evitar resultados como E_USER_ERROR .

A continuación, excluyamos la búsqueda en comentarios y literales de cadena, y limitemos nuestros resultados solo a archivos .php .

A veces también tiene sentido especificar una subcarpeta más concreta del proyecto. En este caso, todo el código específico del proyecto se encuentra en la carpeta de la app .

Así que cambiemos el directorio de ámbito a example-app/app .

Ahora, tenemos una ventana de búsqueda como esta:

¡Solo por ser más específicos en nuestros parámetros de búsqueda, hemos reducido la cantidad de resultados de cientos a solo 24!

Ahora, es muy fácil examinar cada uno de ellos manualmente. Además, ni siquiera necesitamos abrir cada archivo por separado porque tenemos una pestaña de vista previa muy conveniente:

En la práctica diaria, la búsqueda de encontrar en la ruta cubre aproximadamente el 80 por ciento de todas las búsquedas que hago. Es tan útil que incluso si no usa nada más para sus recuperaciones, seguirá siendo bastante eficiente.

Ir a Declaración

Otra habilidad extremadamente importante de PhpStorm (como con todos los IDE modernos) es saltar entre usos y declaraciones de clases y funciones.

Supongamos que tenemos una función que crea un nuevo User . Obviamente, no recordamos todos los métodos y propiedades de la clase User , por lo que debemos examinar la declaración de la clase para decidir cómo realizar todas las acciones necesarias. Hay varias formas de hacerlo.

Primero, puede abrir una declaración de clase como una ventana emergente rápida de solo lectura.

Simplemente mueva el cursor a cualquier uso de clase y presione Ctrl + Shift + I . Aparecerá la ventana de solo lectura:

Puede examinar todos los datos necesarios y volver al archivo inicial. Es extremadamente rápido; ¡ni siquiera necesita cambiar entre archivos!

Pero, como mencioné, la ventana emergente es de solo lectura, por lo que si decide cambiar algo en la clase User mientras la examina, necesitará otro atajo: Ctrl + Shift + B .

Esto lo lleva directamente a la clase. Cuando realiza sus cambios, puede volver fácilmente al archivo inicial, usando Ctrl + E, Enter la secuencia que cubrimos anteriormente.

Listar todos los métodos de la clase actual

La última variante de la función de búsqueda, que uso todos los días, es 'buscar por estructura de clases'. A veces, las clases de PHP son muy largas y es difícil encontrar una propiedad o método en particular.

Si presiona Ctrl + F12 mientras el archivo de clase está abierto, verá una ventana emergente con una estructura de la clase:

Si comienza a escribir el nombre del método, verá solo los métodos que coinciden con el patrón que escribió:

Imagínese que tiene alrededor de 100 métodos (lo cual no es una buena práctica, pero puede encontrarse con dicho código), y necesita cambiar con frecuencia entre dos de ellos. ¡Puede volverte loco usando la búsqueda ordinaria!

Al usar la búsqueda de estructura de archivos en su lugar, cada cambio requerirá aproximadamente cinco pulsaciones de teclas. Simplemente escriba Ctrl + F12 , comience a escribir el nombre del método deseado, presione Enter y accederá a su declaración.

Por cierto, Ctrl + F12 no es un atajo conveniente, por lo que puede considerar cambiarlo por otro. Personalmente, uso Alt + R

Hay muchos más métodos de búsqueda en PhpStorm, pero estos tres pueden cubrir casi todas las tareas de búsqueda diarias.

Un resumen de las funcionalidades de búsqueda

• Si necesita buscar algo que se encuentra en varios archivos, use la búsqueda en la ruta de búsqueda ( Ctrl + Shift + F ) e intente hacer que las opciones de búsqueda (filtrado) sean lo más específicas posible.
• Si necesita ver rápidamente el origen de una clase o un método, use Ctrl + Shift + I y examínelo a través de la ventana emergente rápida (si necesita editarlo, navegue hasta la declaración a través de Ctrl + Shift + B en su lugar).
• Si tiene una clase grande y necesita inspeccionar su estructura o cambiar rápidamente entre métodos, use un atajo de estructura de archivos, Ctrl + F12 por defecto.

Uso de plantillas en vivo para todas las estructuras de lenguaje básicas

Si bien los accesos directos le permiten escribir y navegar por el código rápidamente, hay una manera de mejorarlo aún más: el autocompletado y las plantillas en vivo.

El autocompletado básico es bastante fácil, y sin duda debería saberlo.

Si comienza a escribir el nombre de una clase, método o variable, cualquier buen IDE le mostrará una lista de posibles finales. Puede elegir cualquiera de ellos y evitar escribir hasta el final.

Dicho esto, puedes ir mucho más allá con las plantillas en vivo.

En esta sección, aprenderá qué plantillas activas utilizo en mi trabajo diario. Los divido en tres grupos: construcciones de lenguaje básico, funciones con nombres largos y fragmentos de HTML.

Construcciones Básicas del Lenguaje

No hace falta decir que los desarrolladores usan construcciones de lenguaje estándar, como while , for , foreach , if muchas veces al día, por lo que es extremadamente ineficiente escribirlas desde cero cada vez. Es por eso que hay plantillas en vivo integradas para ellos en PhpStorm.

Para un poco de magia de plantilla en vivo que cambia la vida, abra PhpStorm, escriba forek en el área de edición y presione Enter . Verás esto:

PhpStorm sustituyó una plantilla con un ciclo foreach completo y preparó stubs para todas las variables necesarias. Solo necesita completar los nombres correctos de las variables.

Si presiona Ctrl + J , verá la lista de plantillas en vivo admitidas actualmente, aplicables para el lugar actual del código. Puedes elegir cualquiera de ellos.

Como habrás notado, aquí faltan algunas construcciones muy frecuentes. Por ejemplo, siempre echo de menos una plantilla activa para el ciclo while , ¡así que vamos a crearla!

Vaya a 'Configuración', luego a 'Editor', luego a 'Plantillas en vivo', elija 'PHP' y haga clic en el '+' verde en la parte superior derecha de la ventana emergente:

Complete el campo de 'abreviatura' con 'wh' y el campo de 'descripción' con 'while(bool_expr){…}'. El campo 'texto de la plantilla' debe tener lo siguiente:

 while($EXPR$) { $END$ }

Haga clic en el enlace 'definir' debajo del área de texto 'texto de plantilla' y elija 'PHP' de la lista, para que sepa en qué contexto usar esta plantilla.

Ahora, analicemos cómo funciona.

Cuando escriba wh, Enter en su área de edición, se sustituirá con el texto de la plantilla.

El cursor se moverá a la primera variable de plantilla, $EXPR$ en nuestro caso, luego puede escribir cualquier expresión (por ejemplo, $i > 0 ) y presionar Enter nuevamente.

Después de eso, el cursor se moverá a la siguiente variable (solo tenemos una en este ejemplo), y así sucesivamente. $END$ es una variable especial que indica el lugar donde debe moverse el cursor después de completar todas las variables.

Solo tenemos una variable, por lo que se moverá a $END$ justo después de que completemos $EXPR$ y estaremos listos para ingresar un cuerpo de ciclo.

Cree sus propias plantillas en vivo para todas las construcciones de lenguaje que usa con frecuencia. Es mucho mejor invertir algo de tiempo por adelantado que gastarlo todos los días escribiendo tales construcciones desde cero.

Funciones PHP

Desafortunadamente, PHP tiene la reputación de ser un lenguaje con nombres de funciones largos e inconsistentes.

La buena noticia es que puede sustituirlos por abreviaturas cortas utilizando plantillas en vivo. Por ejemplo, si desea verificar correctamente si existe alguna clave en una matriz, debe llamar a la función array_key_exists($my_key, $my_array) .

Es extremadamente tedioso escribirlo cada vez, incluso con el autocompletado estándar, así que simplemente cree plantillas en vivo para todos esos casos.

Personalmente, prefiero 'ake' para array_key_exists, puedes elegir cualquier otro. Así es como se crea la plantilla en vivo 'ake':

fragmentos de HTML

Por último, pero ciertamente no el uso menos popular de las plantillas en vivo, es el manejo de fragmentos de HTML.

Si aún no está usando plantillas en vivo, apuesto a que ha estado haciendo mucho trabajo tedioso (y básicamente, inútil), creando elementos de marcado HTML estándar. Las plantillas en vivo cambian eso al hacer lo que hemos hecho anteriormente pero con el campo 'texto de plantilla' siendo su HTML.

Evite errores con PHPDocs

Hasta ahora, ha aprendido trucos y consejos de eficiencia de PhpStorm, pero espere, hay más. La eficiencia no es la única área en la que puede ayudar, también puede ayudar a evitar errores, incluso antes de la primera ejecución de su programa.

Fuera de la caja, PhpStorm le informa sobre los errores obvios.

Por ejemplo, si ha olvidado un punto y coma después de una declaración, lo marcará en rojo, pero esa funcionalidad es trivial, por lo que no la describiré.

Lo que es interesante es cuando PhpStorm le informa sobre errores mucho más complejos, cuando le brinda la información que necesita a través de PHPDocs.

Idealmente, las especificaciones de PHPDoc son obligatorias en su equipo para todos los métodos y deben ser lo más rigurosas posible. Considere un ejemplo con nuestra clase User nuevamente. Supongamos que tenemos una función que devuelve una matriz de objetos de User :

De forma predeterminada, no está documentado, por lo que es posible que otros desarrolladores no conozcan el tipo de valor devuelto y lo utilicen de forma incorrecta.

Por ejemplo, algún otro desarrollador quiere recuperar una lista de nombres de usuario. Por alguna razón, piensa, que el objeto User tiene un método getName(). Pero en realidad no es así, por lo que el desarrollador comete un error:

PhpStorm no trata esto como un error porque no sabe nada sobre la variable $user. Entonces pasa desapercibido y terminamos con un error muy desagradable.

La primera opción es simplemente activar la escritura estricta, que se hizo posible en PHP7, pero supongamos que no podemos hacer eso por alguna razón. Tal vez estemos trabajando con código heredado. En este caso, PhpStorm nos ayudará, si se lo permitimos.

Para que esto funcione, deberá generar un PHPDoc para cada función. Por lo general, se considera un buen hábito y lo ayudará a evitar errores, llevarse bien con otros desarrolladores e incluso pasar entrevistas en las que los empleadores examinan su código fuente.

Para generar un PHPDoc, mueva el cursor al nombre de la función, presione Alt + Enter , elija el elemento "Generar PHPDoc para la función" en el menú emergente y presione Enter nuevamente.

Aparecerá la plantilla PHPDoc básica:

Puede ver que PhpStorm adivinó que el valor de retorno es una matriz, pero no pudo adivinar que es una matriz de objetos User , así que estipulemos esto explícitamente cambiando 'arreglo' para leer 'Usuario[]' en su lugar:

Ahora que le hemos dicho a PhpStorm lo que necesita saber sobre el método, volvamos a la llamada al método getUserNames() :

Ahora que PhpStorm puede analizar la declaración de tipo de devolución de PHPDoc, puede señalarnos el error e incluso sugerir qué es exactamente lo que está mal. PhpStorm, en combinación con PHPDocs, puede hacer de PHP un lenguaje muy riguroso. ¡Un resultado increíble!

PhpStorm no es solo para desarrolladores de PHP

Si bien todos los temas cubiertos se centran en el desarrollo de PHP, PhpStorm se basa en una plataforma IntelliJ muy poderosa, lo que hace posible su uso con varios lenguajes, marcos y pilas tecnológicas que están lejos del mundo de PHP.

Desarrollo front-end

Incluso si es un desarrollador de back-end, deberá resolver algunos problemas de front-end de vez en cuando. Puede ser una solución simple en el marcado HTML, agregar un parámetro al cliente REST, escribir en AngularJS, etc. La buena noticia es que todo eso se puede hacer en PhpStorm.

La regla general básica es: compruebe si es compatible desde el primer momento. Si no, intente encontrar un complemento.

Por ejemplo, Javascript, CSS y los preprocesadores de CSS populares, como LESS y SASS, son compatibles de forma inmediata. La compatibilidad con AngularJS se agrega fácilmente como un complemento (la ruta de instalación es la misma que para el complemento IdeaVim). Con esta mentalidad, podrá resolver casi todas las tareas de front-end posibles.

Trabajar con bases de datos

Por lo general, las bases de datos de la aplicación se administran a través de la línea de comandos o herramientas especiales, como MySQL Workbench, pero PhpStorm también puede ayudarlo aquí.

Simplemente haga clic en Base de datos en el margen derecho de su pantalla y verá una lista de bases de datos disponibles (inicialmente vacías) y una ventana de consulta, que tiene autocompletado, como el área de edición común, lo que lo hace muy conveniente.

PhpStorm es compatible con casi todas las bases de datos modernas. MySQL, PostgreSQL, Oracle Database y SQLite son compatibles de fábrica, mientras que MongoDB es compatible mediante la instalación de complementos.

pila MEDIA

El ejemplo final y más sorprendente que no es PHP es el desarrollo de pila MEAN.

MEAN significa MongoDB, ExpressJS, AngularJS, Node.js.

Es una pila de tecnología de tendencia, que se usa en casi todas partes. Es muy rápido y extremadamente bueno para servicios web ligeros y rápidos.

Incluso como desarrollador de PHP, a veces creo servicios de Node.js como herramientas complementarias para proyectos de PHP (por ejemplo, servicios de websocket, back-end de chatbot simples, etc.).

Como probablemente haya adivinado, todos los componentes de la pila MEAN son compatibles con PhpStorm, por lo que siempre que necesite crear un proyecto de pila MEAN, tenga en cuenta que no necesita otro IDE. PhpStorm hará el trabajo perfectamente.

El poder de PhpStorm está en tus manos

Usando el poder de PhpStorm y los conjuntos de habilidades clave que se tratan en este artículo, usted también puede aumentar su eficiencia y evitar errores incluso antes de que termine de escribir.