Preguntes freqüents¶

Aquest document de preguntes freqüents resumeix temes recurrents de les incidències de suport d'MRBS, tant obertes com tancades. Les respostes s'han contrastat amb MRBS 1.12.2; una solució provisional antiga no s'hi inclou només perquè aparegués una vegada en una incidència.

Com es va seleccionar aquesta PMF¶

La revisió va incloure les incidències que tenien com a mínim una d'aquestes etiquetes: Help, Help from scratch, LDAP help need, Problems with room's capacity, support, spanish help, support request, help wanted o custom view help.

El 26 de juliol de 2026, només l'etiqueta support request contenia 3.076 incidències: 1.590 d'obertes i 1.486 de tancades. Moltes corresponen a casos històrics importats, personalitzacions puntuals, sol·licituds de funcions o preguntes sense una resposta confirmada. A continuació només s'inclouen les preguntes recurrents amb una resposta que encara és útil per a la versió 1.12.2. Els enllaços a les incidències indiquen la procedència, però no substitueixen la referència de configuració actual.

Instal·lació i diagnosi¶

Per què veig una pàgina en blanc o HTTP 500?¶

Llegiu primer els registres d'errors del servidor web i PHP. Una pàgina en blanc és només el símptoma visible; l'error útil normalment es troba en un registre. A continuació, comproveu:

la versió de PHP compatible i les extensions requerides;
config.inc.php amb php -l config.inc.php;
connectivitat de la base de dades i el controlador PDO corresponent;
els permisos dels fitxers i la configuració activa de PHP; i
si la sol·licitud fallida arriba a la instal·lació MRBS prevista.

No habiliteu la visualització pública dels errors de PHP en un sistema de producció ni publiqueu credencials en una incidència. Vegeu Resolució de problemes. El cas de suport original #1007 no tenia cap solució específica del producte confirmada; per això, aquesta resposta comença per les dades dels registres locals.

Per què falla l'inici de sessió a la base de dades al cPanel o a l'allotjament compartit?¶

Utilitzeu la base de dades i el nom d'usuari exactes creats pel tauler de control d'allotjament. cPanel sovint els prefixa amb el nom del compte d'allotjament. Comproveu també que l'usuari tingui privilegis en aquesta base de dades. SQLSTATE[28000] o "Accés denegat per a l'usuari" és un error d'autenticació de la base de dades o de concessió, no un error de taula MRBS.

Mantingueu $db_database, $db_login i $db_password coherents amb els valors del tauler de control. Creeu l'esquema només després d'haver establert correctament la connexió. Vegeu la incidència #3801 i Instal·lació.

Per què un canvi de configuració no té cap efecte?¶

Comproveu que heu editat el config.inc.php que carrega aquest desplegament i aquest lloc. Els valors assignats més endavant sobreescriuen els anteriors. La configuració de les àrees existents es desa a la base de dades; modificar areadefaults.inc.php només canvia els valors predeterminats de les àrees noves. En mode multilloc, confirmeu el lloc seleccionat i la seva configuració. Finalment, si escau, buideu o reinicieu la memòria cau d'opcode de PHP.

Vegeu config.inc.php en profunditat i Resolució de problemes.

Inici de sessió i LDAP¶

Com puc demanar als usuaris que iniciïn sessió abans que vegin el calendari?¶

Definiu:

$auth['deny_public_access'] = true;

Proveu la vista sense iniciar sessió en una finestra privada del navegador. Aquest paràmetre bloqueja l'accés al calendari públic, però no selecciona ni configura el sistema d'autenticació. Vegeu la incidència #3979 i Usuaris i permisos.

Per què MRBS diu que falta l'extensió PHP LDAP?¶

Instal·leu o activeu l'extensió LDAP a l'entorn de PHP que utilitza el servidor web i reinicieu-lo. El PHP de la línia d'ordres i el PHP del servidor web poden carregar fitxers php.ini diferents; comproveu, doncs, l'entorn web en comptes de confiar únicament en php -m. El nom exacte del paquet i l'ordre de reinici depenen del sistema operatiu i de la instal·lació de PHP.

Vegeu incidència #1022 i Autenticació LDAP.

Com puc trobar el DN base LDAP i el DN d'usuari correctes?¶

No deduïu l'arbre del directori a partir del nom de l'organització. Consulteu-lo amb un client LDAP com ldapsearch, utilitzant el mateix servidor, mode TLS, DN base, identitat de cerca i atribut de nom d'usuari que utilitzarà MRBS. Active Directory sol utilitzar sAMAccountName i OpenLDAP, uid, però el que preval és l'esquema del directori.

Proveu la identitat de cerca per separat de la vinculació de l'usuari final i no publiqueu mai les contrasenyes de vinculació. Un DN incorrecte va ser la causa principal de la incidència #1083.

Com es pot limitar l'accés LDAP a un grup?¶

Utilitzeu $ldap_filter per decidir quins usuaris del directori poden accedir a MRBS. En una estructura d'Active Directory on la pertinença s'emmagatzema a l'objecte d'usuari, el filtre pot comprovar memberof. En una estructura d'OpenLDAP on la pertinença s'emmagatzema als objectes de grup, configureu $ldap_filter_base_dn, $ldap_filter_user_attr i un $ldap_filter adequat.

Utilitzeu el DN exacte i els noms reals dels atributs del directori, proveu un compte permès i un de rebutjat i confirmeu el comportament dels grups imbricats. Aquests filtres d'accés són independents de $ldap_admin_group_dn, que identifica els administradors d'MRBS. Vegeu la incidència #2033 i Autenticació LDAP.

L'inici de sessió LDAP funciona; per què l'usuari no és un administrador de MRBS?¶

Quan $ldap_admin_group_dn està establert, MRBS utilitza aquest grup en lloc de $auth['admin']. Confirmeu:

el grup complet DN;
$ldap_group_member_attrib — memberof per defecte;
que la identitat de cerca LDAP pot llegir els atributs de pertinença de l'usuari; i
si el directori retorna pertinença directa o imbricada.

Activeu temporalment els diagnòstics LDAP només en un entorn de prova protegit i elimineu-los després. En incidència #3943, la identitat de cerca no va poder llegir inicialment la informació del grup requerida.

Per què pot fallar LDAP després d'una actualització de MRBS encara que l'enllaç de contrasenya funciona?¶

És possible que l'MRBS actual hagi de cercar el DN d'un usuari i atributs com ara el nom de visualització o el correu electrònic. Si la cerca anònima no està disponible, configureu:

$ldap_dn_search_attrib = 'sAMAccountName'; // use the directory's real attribute
$ldap_dn_search_dn = 'search-account@example.org';
$ldap_dn_search_password = 'read-from-a-protected-secret';

Doneu a la identitat de cerca només els permisos de lectura que necessita. Mantingueu la seva contrasenya fora de l'arrel del document i inclogueu-la des d'un fitxer de configuració protegit. Vegeu incidència #3895.

Pot MRBS cercar més d'un directori LDAP?¶

Sí. Molts paràmetres LDAP, inclòs $ldap_host, $ldap_port, $ldap_base_dn, i els atributs de cerca, poden ser matrius. Si un paràmetre LDAP apte per a matriu és una matriu, cada paràmetre amb capacitat per a matriu ha de tenir el mateix nombre d'elements, un per directori.

Proveu l'inici de sessió, la cerca d'atributs, els filtres d'accés i el mapeig de l'administrador per a cada directori. Vegeu incidència #3981 i la secció LDAP a systemdefaults.inc.php.

Reserves, aules i permisos¶

Per què un camp de reserva personalitzat funciona per a una reserva però falla per a una sèrie?¶

Cada columna de reserva personalitzada ha d'existir tant a la taula entry com a repeat, amb el mateix nom, tipus, longitud, admissió de valors nuls i valor predeterminat. Tracteu totes dues columnes com un únic canvi de l'esquema.

Vegeu incidència #3986 i Camps personalitzats.

La capacitat de l'aula impedeix una reserva amb massa participants?¶

No. El valor capacity és una dada descriptiva de l'aula que MRBS mostra, però no es compara automàticament amb el nombre d'assistents d'una reserva. Si un lloc necessita aplicar aquesta regla, afegiu un camp personalitzat per al nombre de participants, idèntic a entry i repeat, i implementeu i mantingueu la validació al servidor. La validació només al navegador no és suficient.

Si la inscripció està habilitada, la capacitat de l'esdeveniment limita les inscripcions d'aquell esdeveniment; no selecciona automàticament una aula de la mida adequada. Vegeu la incidència #1055, Àrees i aules i Camps personalitzats.

Una zona pot utilitzar franges de 30 minuts al matí i de 15 minuts més tard?¶

No mitjançant la configuració d'àrea estàndard. Una àrea té una resolució única. Utilitzeu la resolució més petita necessària durant tot el dia o creeu àrees separades quan els recursos i el model operatiu ho permetin. Una resolució que depèn del temps requereix una personalització de codi mantinguda.

Vegeu incidència #4011.

Per què un creador de reserves no pot veure Editar o Suprimir?¶

Consulteu la política de reserves de l'àrea existent a Aules. Els límits d'antelació per editar reserves futures i les regles aplicables a reserves passades poden ocultar aquestes accions fins i tot al creador. Confirmeu també la identitat amb què s'ha iniciat sessió, la propietat de la reserva, els privilegis d'administrador i si es tracta d'una ocurrència o d'una sèrie.

Modificar areadefaults.inc.php no actualitza una àrea existent. Vegeu la incidència #3994 i Polítiques de reserves.

Les aules d'una reserva múltiple queden vinculades permanentment?¶

No. MRBS crea una entrada de reserva independent per a cada aula. Si més endavant se n'edita o se'n suprimeix una, les altres no continuen formant un grup vinculat. No copieu a cada descripció una llista generada de totes les aules seleccionades, llevat que el lloc també actualitzi aquesta llista durant les operacions de creació, edició i supressió.

Vegeu incidència #2223.

Puc afegir més nivells d'accés o donar accés només als informes d'un rol personalitzat?¶

L'MRBS estàndard utilitza els nivells d'accés 0, 1 i 2. Els rols numèrics addicionals i els permisos específics de la pàgina requereixen una personalització d'autorització local, proves i revisió després de cada actualització. Un pedaç d'un problema antic no és una opció de configuració compatible.

Preferiu la delegació estàndard per àrea o aula i els informes públics amb llistes d'autorització restringides quan satisfacin la necessitat. Vegeu la incidència #3999 i Usuaris i permisos.

Correu electrònic, idioma i hora¶

Per què la depuració de correu electrònic informa "Sense destinataris"?¶

Activeu com a mínim un dels tipus de destinatari previstos:

$mail_settings['admin_on_bookings'] = true;
$mail_settings['area_admin_on_bookings'] = true;
$mail_settings['room_admin_on_bookings'] = true;
$mail_settings['booker'] = true;

Per a la primera opció, definiu $mail_settings['recipients']. Mantingueu a MRBS les adreces electròniques dels administradors d'àrea i d'aula. Si cal notificar el creador d'una reserva autenticat amb LDAP, l'usuari necessita un atribut de correu llegible i assignat correctament. A continuació, proveu per separat la creació, l'edició i la supressió d'esdeveniments.

Vegeu incidència #3795 i Notificacions per correu electrònic.

Per a quin valor he d'utilitzar `$override_locale`?¶

Utilitzeu una etiqueta d'idioma BCP 47 com ara en, en-GB, de, fr, o es, no una cadena de configuració regional del sistema operatiu. El servidor encara ha de tenir les dades locals adequades. En sistemes semblants a Unix, locale -a mostra les configuracions locals instal·lades.

Deixeu $override_locale buit per utilitzar la selecció automàtica d'MRBS. Vegeu la incidència #3984 i Text i traduccions.

Per què es mostren les hores exactament una hora incorrectes?¶

Comproveu, per ordre:

la zona horària de l'aula i de l'àrea;
el global $timezone;
el paquet de dades de zona horària i zona horària de PHP;
la transició a l'horari d'estiu de la data afectada; i
si la marca de temps emmagatzemada o només la seva visualització és incorrecta.

Utilitzeu una zona horària IANA com ara Europe/Berlin, no un desplaçament UTC fix. Els problemes antics mencionen solucions alternatives de format específic de la versió; $force_strftime no és una configuració a MRBS 1.12.2 i no s'ha de copiar incidència #3967. Vegeu Resolució de problemes.

Com personalitzo o tradueixo la pàgina d'ajuda i el text de la interfície?¶

La pàgina d'ajuda de l'aplicació es carrega des de web/site_faq/. Per exemple, el castellà utilitza site_faq_es.html; definiu $faqfilelang = 'es' si cal seleccionar explícitament aquesta llengua. Mantingueu un fitxer traduït complet per a cada llengua admesa.

Per a canvis breus de la interfície, utilitzeu $vocab_override[LANG][TOKEN] a config.inc.php en comptes d'editar web/lang/lang.*. Els camps personalitzats de la base de dades utilitzen claus com entry.catering.

Vegeu incidència #2432 i Text i traduccions.

Informes, multilloc i personalització¶

Com pot un treball programat exportar un informe o dades d'iCalendar?¶

Els informes GET sense autenticació estan desactivats per defecte. Si és acceptable exposar la informació d'aquesta manera, habiliteu-los expressament i restringiu-los amb:

$report_unauthenticated_get_enabled = true;
$report_keys_enabled = true;
$report_keys = ['a-long-random-secret'];
$report_open_areas = [1];
$report_open_rooms = [];

Utilitzeu una clau difícil d'endevinar, una llista molt restringida d'àrees i aules, HTTPS i un planificador de tasques protegit. Comproveu el resultat exacte sense iniciar sessió. L'URL de l'informe actua com una credencial i es pot filtrar als registres o a l'historial.

Vegeu incidència #3742 i Recerca i informes.

Poden diversos llocs MRBS compartir un conjunt de taules?¶

No, no si les seves reserves i la seva configuració han de ser independents. Cada lloc necessita les seves pròpies taules MRBS, ja sigui en una base de dades independent o amb una única $db_tbl_prefix en una base de dades compartida. El codi es pot compartir, però els conjunts de taules no s'han de solapar.

Creeu les taules de cada lloc amb els scripts d'esquema MRBS i apliqueu-ne el prefix de manera coherent. Vegeu incidència #3917 i Multilloc.

Cada vista o tema sol·licitat està disponible mitjançant la configuració?¶

No. Peticions com inserir text addicional d'una aula en una vista concreta del calendari, vincular reserves que altrament serien independents, afegir nivells d'accés o substituir l'arquitectura del tema poden requerir canvis al codi. Abans d'aplicar un pedaç procedent d'una incidència de suport:

comproveu si 1.12.2 ja té un punt de configuració o d'extensió;
mantingueu el canvi fora dels fitxers generats i dels fitxers de tercers;
afegiu proves de creació, edició, supressió, privadesa i permisos; i
documenteu la personalització per a l'actualització següent.

Alguns exemples inclouen problema de vista personalitzada #2223 i Sol·licitud del tema #22.